Leitfaden für die M-Pesa-Express-API (STK-Push)

Die M-Pesa Express API, auch bekannt als STK/NI Push API, ermöglicht es Unternehmen, Online-Zahlungen im Namen ihrer Kunden zu initiieren und bietet so ein nahtloses Zahlungserlebnis. Durch die Integration mit dieser API können Unternehmen einen Zahlungsprompt an das Telefon des Kunden senden, der die Zahlung durch Eingabe seines M-PESA-PINs autorisieren kann. Dies eliminiert die Notwendigkeit, Geschäftspaybill-Nummern oder Kontonummern zu merken. Die API verwendet eine POST-Methode und erfordert ein Zugriffstoken, das über die Autorisierungs-API generiert wird. Der Workflow umfasst die Einstellung der erforderlichen Parameter durch den Händler und das Senden der API-Anfrage, die dann validiert und einen STK-Push-Prompt auf das Telefon des Kunden auslöst. Der Kunde autorisiert die Zahlung durch Eingabe seines M-PESA-PINs, und M-PESA verarbeitet die Zahlung durch Überprüfung des PINs, Belastung des Kundenkontos und Gutschrift auf das Händlerkonto. Der API-Anfragekörper erfordert Parameter wie BusinessShortCode, Passwort, Zeitstempel, Transaktionstyp, Betrag, Partei A, Partei B, Telefonnummer, CallBackURL, Kontoverweis und Transaktionsbeschreibung. Die API gibt eine Antwort mit Parametern wie MerchantRequestID, CheckoutRequestID, ResponseCode, ResponseDescription und CustomerMessage zurück. Nachdem die Transaktion verarbeitet wurde, sendet M-PESA einen Callback mit dem Ergebnis an die angegebene CallBackURL. Das Ergebnis des Callbacks enthält Parameter wie MerchantRequestID, CheckoutRequestID, ResultCode, ResultDesc und CallbackMetadata. Die CallbackMetadata enthält zusätzliche Transaktionsdetails wie Betrag, Mpesa-Quittungsnummer, Transaktionsdatum und Telefonnummer. Fehlercodes werden auch bereitgestellt, um Probleme während der Implementierung zu diagnostizieren und zu lösen. Diese Fehlercodes umfassen DS-Timeout, Probleme mit der Push-Anfrage, allgemeine Push-Anfragefehler, Benutzer haben die Anfrage abgebrochen, unzureichender Saldo, ungültige Initiatorinformationen, abgelaufene Transaktion und Abonnentensperrfehler.