Payment Notify API

Tips

• All requests are Post requests, and the data format is json

Brief Description

• This document describes the asynchronous notification to merchants. When a transaction (payout, payin) has a result, the result will be posted to the URL reported by the merchant. The merchant must respond with OK after processing the transaction result. If the platform request fails, it will notify the merchant 8 times within 24 hours according to a specific rule: 2s/5s/10s/30s/1h/3h/3h/3h. If the merchant still does not receive the result successfully, they can actively query the result through the query interface.

• If the merchant's request has IP restrictions, please inform us.

Request Method

• POST

Request Parameters

Name	Required	Type	Description
platFormTradeNo	Yes	string	paypro transaction number
tradeNo	Yes	string	Merchant transaction number
amount	Yes	string	Transaction amount
status	Yes	string	Request result, merchants can use this for logic processing. When the result is 0000, it indicates a successful transaction; 0015 indicates processing; all other codes indicate errors and can be treated as failures.
message	Yes	string	Error description
successTime	Yes	string	Transaction success time (Kenya time)

Request Example

{
   "platFormTradeNo": "5286e98841194687a95d25b5f3be346d",
   "tradeNo": "00000020",
   "amount": 3.0000,
   "status": "00029",
   "message": "REJECTED_TRANSACTION",
   "successTime": "2024-07-01 18:34:31"
}