Aller au contenu

Paiement de factures · Mexique

Payez les impôts fédéraux au Mexique par référence, via une seule API.

BillPay règle les références de paiement administratives via l’API de décaissement que vous utilisez déjà. Disponible aujourd’hui au Mexique, en MXN, pour le paiement des impôts fédéraux au SAT.

  • Mexique · MXN
  • Impôts fédéraux SAT
  • Double signature optionnelle
Mexique, en pesos mexicains
MXN
Impôts fédéraux, billType 0098
SAT
Étape de validation avant l’envoi d’un paiement
Facultative
À chaque changement de statut
Webhook

Pourquoi BillPay

Le paiement des impôts intégré à votre produit

Vos clients ne devraient pas avoir à quitter votre plateforme pour payer le SAT. BillPay transforme une référence fiscale en un décaissement de plus.

  • Une seule intégration

    BillPay est un moyen de décaissement (type BillPay, code 0119). Si vous envoyez déjà des décaissements, l’essentiel de l’intégration est fait.

  • Paiement par référence

    Envoyez le type de facture, la référence de paiement et le montant. Localpayment règle la référence pour le compte de votre client.

  • Validations optionnelles

    Ajoutez requireAuth pour qu’un second utilisateur habilité donne son accord avant tout paiement.

  • Des statuts clairs

    Sept statuts documentés, de PENDING à COMPLETED, FAILED, EXPIRED ou REVERSED.

  • Payé depuis un compte dédié

    Les paiements de factures sont débités d’un compte Localpayment approvisionné pour les paiements d’impôts et de factures.

  • Rapproché avec le reste

    Les paiements de factures apparaissent dans les mêmes rapports, activités et webhooks que le reste de vos opérations.

Fonctionnement

De la référence fiscale au paiement, en quatre étapes

  1. 01

    Soumettre la référence

    Appelez POST /api/payout/ avec le type BillPay (code 0119), le billType 0098, la billReference SAT et le montant.

  2. 02

    Vérification

    Localpayment contrôle la requête et l’accepte avec votre externalId. Le montant est celui que déclare votre intégration.

  3. 03

    Validation (facultative)

    Avec requireAuth, un second utilisateur valide dans le Business Portal ou via l’API avant tout envoi.

  4. 04

    Payé + webhook

    La référence est payée et un webhook signé indique COMPLETED, prêt à être rapproché du reste de vos décaissements.

Statuts

Chaque statut de transaction, clairement défini

Chaque paiement de facture remonte l’un des sept statuts, par webhook et via l’API de statut des transactions.

  • En attente (PENDING)

    Signification
    Accepté et en attente de traitement.
  • En attente de validation (PENDING_AUTH)

    Signification
    En attente d’un second approbateur (requireAuth).
  • En cours (IN_PROGRESS)

    Signification
    La référence est en cours de paiement.
  • Abouti (COMPLETED)

    Signification
    La référence a été payée.
  • Échoué (FAILED)

    Signification
    Le paiement n’a pas pu aboutir ; la réponse en indique la raison.
  • Expiré (EXPIRED)

    Signification
    Le paiement a dépassé le délai de traitement.
  • Contre-passé (REVERSED)

    Signification
    Un paiement traité a été annulé (contre-passé).

Votre intégration déclare le montant ; Localpayment ne le vérifie pas par rapport à la référence. Descriptions résumées. Consultez le guide BillPay de la documentation pour les définitions exactes et les codes d’erreur.

Pour qui

Conçu pour les plateformes au service des entreprises mexicaines

Intégrez le paiement des impôts fédéraux là où vos clients gèrent déjà leur argent, et supprimez l’étape où ils quittent votre produit pour payer.

  • Logiciels de comptabilité, de paie et ERP : payez les impôts fédéraux depuis votre produit
  • Fintechs et portefeuilles professionnels : laissez vos utilisateurs payer le SAT depuis leur solde
  • Prestataires de services aux entreprises : automatisez les paiements d’impôts des sociétés que vous gérez

Pour les développeurs

Un paiement de facture, c’est un décaissement avec une référence

Utilisez l’endpoint Create Payout avec le moyen BillPay et les informations de facture du bénéficiaire. Authentifiez-vous avec un jeton Bearer et recevez le résultat par webhook signé.

  • paymentMethod.type BillPay, code 0119
  • beneficiary.billType 0098 (impôts fédéraux, SAT) et billReference
  • requireAuth optionnel pour une seconde validation
# Requête illustrative — consultez docs.localpayment.com pour le contrat exact
curl -X POST https://api.stage.localpayment.com/api/payout/ \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "9a7e5c3b-0000-4000-8000-000000000119",
    "paymentMethod": { "type": "BillPay", "code": "0119", "flow": "DIRECT" },
    "country": "MEX",
    "currency": "MXN",
    "amount": 12500.00,
    "accountNumber": "<your-account-number>",
    "requireAuth": true,
    "beneficiary": { "billType": "0098", "billReference": "0426ABCD12345678901X" },
    "sender": { "type": "COMPANY", "name": "Nortia Commerce S.A. de C.V." },
    "merchant": { "type": "COMPANY", "name": "<your-company-name>" }
  }'

Questions fréquentes

Dans quels pays BillPay est-il disponible ?

BillPay est disponible au Mexique, en MXN. Si vous avez besoin de paiements de factures ou d’impôts sur un autre marché, parlez de votre cas d’usage à notre équipe.

Quelles factures puis-je payer ?

Aujourd’hui, le catalogue billType couvre les impôts fédéraux payés au SAT (billType 0098).

Que dois-je envoyer ?

Le type de facture, la référence de paiement et le montant, ainsi que les champs de décaissement habituels comme votre externalId et votre numéro de compte.

S’agit-il d’une intégration distincte ?

Non. BillPay est un moyen de paiement de l’API de décaissement : il utilise la même authentification, les mêmes statuts, webhooks et rapports que vos autres décaissements.

Puis-je ajouter une étape de validation ?

Oui. Envoyez le paiement avec requireAuth : il reste en PENDING_AUTH jusqu’à ce qu’un second utilisateur habilité le valide.

Comment savoir si le paiement a abouti ?

Vous recevez un webhook signé à chaque changement de statut, et vous pouvez interroger l’API de statut des transactions à tout moment avec votre externalId.

Dans quelle devise les factures sont-elles payées ?

En pesos mexicains (MXN), débités d’un compte Localpayment au Mexique approvisionné pour les paiements d’impôts et de factures. Alimentez-le avec vos encaissements locaux ou un Wire In, et utilisez le change pour convertir depuis une devise forte si nécessaire.

Y a-t-il des limites de montant ?

Le minimum est de 0,01 MXN et il n’y a pas de plafond. Le montant envoyé doit correspondre à celui de la référence.

Automatisez le paiement des impôts au Mexique

Ajoutez BillPay à votre intégration de décaissements et laissez vos clients payer le SAT sans quitter votre produit.

Comment pouvons-nous vous aider ?

Téléchargez votre exemplaire

Laissez vos coordonnées et recevez l’édition complète immédiatement.