Zum Inhalt springen

Rechnungszahlung · Mexiko

Zahlen Sie Bundessteuern in Mexiko per Referenz – über eine API.

BillPay begleicht behördliche Zahlungsreferenzen über die Payout-API, die Sie bereits nutzen. Heute verfügbar in Mexiko, in MXN, für Bundessteuerzahlungen an die SAT.

  • Mexiko · MXN
  • SAT-Bundessteuern
  • Optionale Doppelsignatur
Mexiko, in mexikanischen Pesos
MXN
Bundessteuern, billType 0098
SAT
Freigabeschritt, bevor eine Zahlung gesendet wird
Optional
Bei jeder Statusänderung
Webhook

Warum BillPay

Steuerzahlungen direkt in Ihrem Produkt

Ihre Kunden sollten Ihre Plattform nicht verlassen müssen, um die SAT zu bezahlen. BillPay macht aus einer Steuerreferenz einfach eine weitere Auszahlung.

  • Eine Integration

    BillPay ist eine Auszahlungsmethode (Typ BillPay, Code 0119). Wenn Sie bereits Auszahlungen senden, ist der Großteil der Integration erledigt.

  • Zahlung per Referenz

    Senden Sie Rechnungstyp, Zahlungsreferenz und Betrag. Localpayment begleicht die Referenz im Auftrag Ihres Kunden.

  • Optionale Freigaben

    Fügen Sie requireAuth hinzu, damit ein zweiter berechtigter Nutzer zustimmt, bevor etwas bezahlt wird.

  • Klare Status

    Sieben dokumentierte Status – von PENDING bis COMPLETED, FAILED, EXPIRED oder REVERSED.

  • Aus einem eigenen Konto bezahlt

    Rechnungszahlungen werden von einem Localpayment-Konto abgebucht, das für Steuer- und Rechnungszahlungen aufgeladen ist.

  • Gemeinsam abgeglichen

    Rechnungszahlungen erscheinen in denselben Berichten, Aktivitäten und Webhooks wie Ihre übrigen Vorgänge.

So funktioniert es

Von der Steuerreferenz zur Zahlung in vier Schritten

  1. 01

    Referenz übermitteln

    Rufen Sie POST /api/payout/ mit dem Typ BillPay (Code 0119), billType 0098, der SAT-billReference und dem Betrag auf.

  2. 02

    Prüfung

    Localpayment prüft die Anfrage und nimmt sie mit Ihrer externalId an. Maßgeblich ist der Betrag, den Ihre Integration angibt.

  3. 03

    Freigabe (optional)

    Mit requireAuth gibt ein zweiter Nutzer im Business Portal oder per API frei, bevor etwas gesendet wird.

  4. 04

    Bezahlt + Webhook

    Die Referenz wird bezahlt und ein signierter Webhook meldet COMPLETED – bereit zum Abgleich mit Ihren übrigen Auszahlungen.

Status

Jeder Transaktionsstatus klar definiert

Jede Rechnungszahlung meldet einen von sieben Status – per Webhook und über die Transaktionsstatus-API.

  • Ausstehend (PENDING)

    Bedeutung
    Angenommen und wartet auf die Verarbeitung.
  • Freigabe ausstehend (PENDING_AUTH)

    Bedeutung
    Wartet auf eine zweite Freigabe (requireAuth).
  • In Bearbeitung (IN_PROGRESS)

    Bedeutung
    Die Referenz wird gerade bezahlt.
  • Abgeschlossen (COMPLETED)

    Bedeutung
    Die Referenz wurde bezahlt.
  • Fehlgeschlagen (FAILED)

    Bedeutung
    Die Zahlung konnte nicht abgeschlossen werden; die Antwort nennt den Grund.
  • Abgelaufen (EXPIRED)

    Bedeutung
    Die Zahlung hat das Zeitlimit für die Verarbeitung überschritten.
  • Rückgängig gemacht (REVERSED)

    Bedeutung
    Eine verarbeitete Zahlung wurde rückgängig gemacht.

Ihre Integration gibt den Betrag an; Localpayment prüft ihn nicht gegen die Referenz. Zusammengefasste Beschreibungen. Genaue Definitionen und Fehlercodes finden Sie im BillPay-Leitfaden der Dokumentation.

Für wen

Für Plattformen, die mexikanische Unternehmen bedienen

Integrieren Sie Bundessteuerzahlungen dort, wo Ihre Kunden ihr Geld ohnehin verwalten – und streichen Sie den Schritt, bei dem sie Ihr Produkt zum Bezahlen verlassen.

  • Buchhaltungs-, Lohn- und ERP-Software: Bundessteuern direkt aus Ihrem Produkt bezahlen
  • Fintechs und Business-Wallets: Nutzer zahlen die SAT aus ihrem Guthaben
  • Dienstleister für Unternehmen: Steuerzahlungen für die von Ihnen betreuten Firmen automatisieren

Für Entwickler

Eine Rechnungszahlung ist eine Auszahlung mit Referenz

Nutzen Sie den Endpunkt Create Payout mit der Methode BillPay und den Rechnungsdaten des Empfängers. Authentifizieren Sie sich mit einem Bearer-Token und erhalten Sie das Ergebnis per signiertem Webhook.

  • paymentMethod.type BillPay, Code 0119
  • beneficiary.billType 0098 (Bundessteuern, SAT) und billReference
  • Optional requireAuth für eine zweite Freigabe
# Beispielanfrage – den genauen Vertrag finden Sie auf docs.localpayment.com
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>" }
  }'

Häufig gestellte Fragen

In welchen Ländern ist BillPay verfügbar?

BillPay ist in Mexiko in MXN verfügbar. Wenn Sie Rechnungs- oder Steuerzahlungen in einem anderen Markt benötigen, sprechen Sie mit unserem Team über Ihren Anwendungsfall.

Welche Rechnungen kann ich bezahlen?

Derzeit umfasst der billType-Katalog Bundessteuern, die an die SAT gezahlt werden (billType 0098).

Welche Daten muss ich senden?

Rechnungstyp, Zahlungsreferenz und Betrag sowie die üblichen Auszahlungsfelder wie Ihre externalId und Kontonummer.

Ist das eine separate Integration?

Nein. BillPay ist eine Zahlungsmethode der Payout-API und nutzt daher dieselbe Authentifizierung, dieselben Status, Webhooks und Berichte wie Ihre übrigen Auszahlungen.

Kann ich einen Freigabeschritt hinzufügen?

Ja. Senden Sie die Zahlung mit requireAuth – dann wartet sie im Status PENDING_AUTH, bis ein zweiter berechtigter Nutzer sie freigibt.

Woran erkenne ich, dass die Zahlung durchgegangen ist?

Bei jeder Statusänderung erhalten Sie einen signierten Webhook, und Sie können die Transaktionsstatus-API jederzeit mit Ihrer externalId abfragen.

In welcher Währung werden Rechnungen bezahlt?

In mexikanischen Pesos (MXN), belastet von einem Localpayment-Konto in Mexiko, das für Steuer- und Rechnungszahlungen aufgeladen ist. Füllen Sie es mit lokalen Zahlungseingängen oder einem Wire In auf und nutzen Sie FX, um bei Bedarf aus einer Hartwährung zu konvertieren.

Gibt es Betragslimits?

Der Mindestbetrag liegt bei MXN 0,01, ein Höchstbetrag besteht nicht. Der gesendete Betrag muss dem in der Referenz hinterlegten Betrag entsprechen.

Automatisieren Sie Steuerzahlungen in Mexiko

Ergänzen Sie Ihre Payout-Integration um BillPay und lassen Sie Ihre Kunden die SAT bezahlen, ohne Ihr Produkt zu verlassen.

Wie können wir helfen?

Ihr Exemplar herunterladen

Hinterlassen Sie Ihre Daten und erhalten Sie sofort die vollständige Ausgabe.