post https://api-approval.tingg.africa/v3/checkout-api/charge/request
This function is used by merchants to post a charge request i.e. request to debit amount from customer for the checkout request that was posted earlier in the request/initiate function.
Live Endpoint
| Key | Value Type | Required | Description |
|---|---|---|---|
charge_msisdn | String | Yes | Mobile number used to raise the request |
charge_amount | Double | Yes | Payment the customer wished to pay. |
country_code | String | Yes | ISO Country code you wish to charge the request in |
currency_code | String | Yes | ISO Country code to initiate the payment in |
merchant_transaction_id | String | Yes | Initial checkout request transaction id raised by merchant |
service_code | String | Yes | The service code assigned to the merchant on the tingg portal |
payment_option_code | String | Yes | The actual payer client code the merchant initiates the request for. |
{
"charge_msisdn": 254700000000,
"charge_amount": 100,
"country_code": "KEN",
"currency_code": "KES",
"merchant_transaction_id": "TinggTest01",
"service_code": "TINGGTEST",
"payment_mode_code": "STK_PUSH",
"payment_option_code": "SAFKE"
}
Response Status Codes
| Status Code | Description |
|---|---|
| 200 | Success. Checkout request successfully logged in the checkout platform. |
| 500 | Failure. Generic failure occurred. Could be as a result of a system failure on the checkout platform. |
| 1001 | No request found. |
| 1007 | Missing country code. The checkout request posted was missing a country_code |
| 1013 | Not JSON. The checkout request posted was not valid JSON |
| 1014 | Missing merchant transaction id. The request did not have a merchant_transaction_id |
| 1015 | Missing checkout request id.The request did not have a checkout_request_id |
| 1017 | Invalid charge msisdn provided. The charge_msisdn provided was not valid in the country provided |
| 1027 | Invalid amount provided. The charge_amount should be between the minimum and maximum amounts provided for the payment option. |
| 173 | Request initiated successfully |
| 422 | Invalid request |
| 191 | Refund Expired |