M-Pesa Express (STK Push) API ガイド

M-Pesa Express API（別名：STK/NI Push API）は、ビジネスが顧客の代わりにオンライン決済を開始できるようにし、シームレスな決済体験を提供します。このAPIを統合することで、ビジネスは顧客の電話に決済のプロンプトを送信し、顧客はM-PESA PINを入力して決済を承認できます。これにより、ビジネスの支払い番号や口座番号を覚える必要がなくなります。 このAPIはPOSTメソッドを使用し、Authorization APIを介して生成されたアクセストークンが必要です。ワークフローは、商人が必要なパラメータを設定し、APIリクエストを送信し、STK Pushプロンプトが顧客の電話にトリガーされるというものです。顧客はM-PESA PINを入力して決済を承認し、M-PESAはPINを検証し、顧客の口座を引き落とし、商人の口座に資金を追加します。 APIリクエストボディには、BusinessShortCode、Password、Timestamp、TransactionType、Amount、PartyA、PartyB、PhoneNumber、CallBackURL、AccountReference、TransactionDescなどのパラメータが必要です。APIは、MerchantRequestID、CheckoutRequestID、ResponseCode、ResponseDescription、CustomerMessageなどのパラメータを含むレスポンスを返します。 取引が処理された後、M-PESAは結果を指定されたCallBackURLにコールバックします。コールバック結果には、MerchantRequestID、CheckoutRequestID、ResultCode、ResultDesc、CallbackMetadataなどのパラメータが含まれます。CallbackMetadataには、Amount、MpesaReceiptNumber、TransactionDate、PhoneNumberなどの取引の詳細情報が含まれます。 エラーコードも提供されており、実装中に発生する問題を診断して解決するのに役立ちます。これらのエラーコードには、DSタイムアウト、プッシュリクエストの問題、一般的なプッシュリクエストエラー、ユーザーがリクエストをキャンセルした、残高不足、開始者の情報が無効、取引が期限切れ、サブスクライバーのロックエラーなどがあります。