Aller au contenu

Décaissements · Mexique

Paiement d’impôts, de factures et de services au Mexique, depuis la plateforme que vous utilisez déjà.

Payez les impôts fédéraux depuis la plateforme que vous utilisez déjà, avec la référence de paiement correspondante, et suivez le statut de chaque paiement grâce aux notifications webhook.

Contacter l’équipe commercialeVoir la documentation
  • Mexique · MXN
  • Impôts fédéraux
  • Notifications webhook

Avantages clés

Simplifiez vos opérations de paiement d’impôts au Mexique

Le paiement d’impôts, de factures et de services est une méthode de décaissement : au lieu d’envoyer des fonds vers un compte bancaire, vous réglez une référence administrative ou de service pour le compte du bénéficiaire.

  • Payez les impôts fédéraux depuis la même plateforme

    Un paiement d’impôt est un décaissement de plus (BillPay, code 0119) sur l’API Localpayment que vous utilisez déjà.

  • Payez avec la référence de paiement

    Envoyez le type d’impôt et la référence de paiement correspondante ; au Mexique, la référence de paiement du SAT.

  • Disponible au Mexique (MEX / MXN)

    Pour les clients qui opèrent au Mexique, avec des paiements en pesos mexicains.

  • Suivez le statut par webhook

    Votre backend reçoit le statut final de chaque paiement via des notifications webhook.

Fonctionnement

De la référence de paiement au paiement finalisé

  1. 01

    Envoyez le paiement

    Appelez POST /api/payout/ avec paymentMethod.type BillPay, ainsi que billType et billReference dans l’objet beneficiary.

  2. 02

    Validation

    Localpayment valide les champs obligatoires et le catalogue billType.

  3. 03

    Validation interne (facultative)

    Avec requireAuth à true, le paiement reste en PENDING_AUTH jusqu’à ce que vous appeliez l’endpoint d’autorisation.

  4. 04

    Paiement

    Localpayment traite le paiement avec l’administration fiscale ou l’émetteur.

  5. 05

    Webhook

    Localpayment met à jour le statut de la transaction et vous en informe par webhook.

Statuts de transaction

Chaque statut de paiement, clairement défini

  • PENDING

    Type
    Intermédiaire
    Description
    La transaction a été reçue et est en cours de traitement.

  • PENDING_AUTH

    Type
    Intermédiaire
    Description
    requireAuth était à true : en attente de votre appel à l’endpoint d’autorisation.

  • IN_PROGRESS

    Type
    Intermédiaire
    Description
    La transaction est en cours de traitement par l’émetteur.

  • COMPLETED

    Type
    Final
    Description
    Le paiement a été traité avec succès.

  • FAILED

    Type
    Final
    Description
    Le paiement a été rejeté ; le tableau errors de la réponse en indique la raison.

  • EXPIRED

    Type
    Final
    Description
    La transaction a dépassé le délai de traitement.

  • REVERSED

    Type
    Final
    Description
    Le paiement a été annulé (reversé).

Localpayment ne vérifie pas que le montant déclaré correspond au montant encodé dans la référence : votre intégration déclare le montant correct.

Pour les développeurs

Un paiement d’impôt est un décaissement avec une référence

Utilisez l’endpoint Create a Payout avec paymentMethod.type BillPay. Au lieu d’un compte bancaire, l’objet beneficiary contient le type d’impôt et la référence officielle.

  • paymentMethod.type BillPay, code 0119, flux DIRECT
  • beneficiary.billType 0098 : impôts fédéraux
  • beneficiary.billReference : la référence de paiement SAT de 20 caractères
Envoyer un paiement d’impôt, de facture ou de service
# Exemple de requête sur Stage — voir docs.localpayment.com pour le contrat complet
curl --request POST \
  --url https://api.stage.localpayment.com/api/payout/ \
  --header 'Authorization: Bearer <your_access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "externalId": "550e8400-e29b-41d4-a716-446655440000",
    "country": "MEX",
    "currency": "MXN",
    "amount": 100.00,
    "accountNumber": "<your_account_number>",
    "paymentMethod": { "type": "BillPay", "code": "0119", "flow": "DIRECT" },
    "beneficiary": { "billType": "0098", "billReference": "20260713000000000001" },
    "sender": { "type": "INDIVIDUAL", "name": "Jane", "lastName": "Doe" },
    "merchant": { "type": "COMPANY", "name": "Merchant Name" }
  }'

Questions fréquentes

Où est-ce disponible ?

Au Mexique (MEX), en pesos mexicains (MXN). Il s’agit d’un décaissement : Localpayment envoie les fonds vers une référence administrative ou de service pour le compte du bénéficiaire.

Quels impôts puis-je payer aujourd’hui ?

Le catalogue billType pour le Mexique couvre les impôts fédéraux (billType 0098). Il s’enrichit à mesure que de nouveaux types d’impôts et de services sont ajoutés ; confirmez-le avec votre gestionnaire de compte avant de passer en production avec un nouveau type.

De quoi ai-je besoin pour commencer ?

Des identifiants API, un compte dédié approvisionné pour les paiements d’impôts et de factures, le billType que vous prévoyez de payer et la référence de paiement (au Mexique, celle du SAT) fournie par le contribuable ou l’émetteur.

Comment suivre chaque paiement ?

Localpayment notifie le statut final à votre endpoint par webhook, avec l’externalId, le billType et la billReference. Une livraison échouée est relancée jusqu’à 3 fois avec un backoff exponentiel, et vous pouvez toujours récupérer la transaction via l’API.

Localpayment vérifie-t-il le montant ?

Non. Votre intégration déclare le montant encodé dans la référence et vérifie que celle-ci n’a pas déjà été payée, car une référence payée ne peut pas être réutilisée. Les références SAT expirées sont rejetées une fois validées auprès du SAT.

Aussi sur la même API

Simplifiez vos opérations de paiement d’impôts au Mexique

Payez les impôts fédéraux depuis la plateforme que vous utilisez déjà et suivez chaque paiement grâce aux notifications webhook.

Contacter l’équipe commercialeVoir la documentation

Comment pouvons-nous vous aider ?

Téléchargez votre exemplaire

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