Guide de l'API M-Pesa Express (Poussée STK)

L'API Express M-Pesa, également connue sous le nom d'API Push STK/NI, permet aux entreprises d'initier des paiements en ligne au nom des clients, offrant une expérience de paiement sans heurt. En intégrant cette API, les entreprises peuvent envoyer une sollicitation de paiement au téléphone du client, ce qui permet à ce dernier d'autoriser le paiement en saisissant son code PIN M-PESA. Cela élimine la nécessité de se rappeler les numéros de paybill ou les numéros de compte des entreprises. L'API utilise une méthode POST et nécessite un jeton d'accès généré via l'API d'autorisation. Le flux de travail implique que le marchand définit les paramètres requis et envoie la demande d'API, qui est ensuite validée et déclenche une sollicitation Push STK sur le téléphone du client. Le client autorise le paiement en saisissant son code PIN M-PESA, et M-PESA traite le paiement en vérifiant le code PIN, débitant le compte du client et créditant le compte du marchand. Le corps de la demande d'API nécessite des paramètres tels que BusinessShortCode, Password, Timestamp, TransactionType, Amount, PartyA, PartyB, PhoneNumber, CallBackURL, AccountReference et TransactionDesc. L'API renvoie une réponse avec des paramètres tels que MerchantRequestID, CheckoutRequestID, ResponseCode, ResponseDescription et CustomerMessage. Après que la transaction a été traitée, M-PESA envoie un rappel avec le résultat à l'URL de rappel spécifiée. Le résultat du rappel comprend des paramètres tels que MerchantRequestID, CheckoutRequestID, ResultCode, ResultDesc et CallbackMetadata. Le CallbackMetadata contient des détails de transaction supplémentaires tels que Amount, MpesaReceiptNumber, TransactionDate et PhoneNumber. Des codes d'erreur sont également fournis pour aider à diagnostiquer et résoudre les problèmes rencontrés lors de l'implémentation. Ces codes d'erreur incluent le délai d'attente DS, le problème avec la demande Push, l'erreur générale de demande Push, l'utilisateur a annulé la demande, le solde insuffisant, les informations d'initiateur invalides, la transaction a expiré et l'erreur de verrouillage de l'abonné.