post https://api-approval.tingg.africa/v3/checkout-api/acknowledgement/request
Customer first initiates a checkout request with details required to collect the payment.
This is when the merchant wants to acknowledge the request with a final status or a delivered status. This is sent as a JSON POST request.
Live Endpoint
https://api.tingg.africa/v3/checkout-api/acknowledgement/request
| Key | Value Type | Required | Description |
|---|---|---|---|
acknowledgement_amount | Double | Yes | Amount to be acknowledged. Compulsory if type is PARTIAL |
acknowledgement_type | String | Yes | Full or Partial |
acknowledgement_narration | String | Yes | Narration of acknowledgement initiated by a merchant. |
acknowledgment_reference | String | Yes | Unique identifier for acknowledgement initiated by customer. |
merchant_transaction_id | String | Yes | Unique identifier from the merchant. |
service_code | String | Yes | The service code assigned to the merchant on the tingg portal |
status_code | int | Yes | The status code indicating status of the transaction on the merchant’s end |
currency_code | String | Yes | 3 letter ISO currency code. |
{
"acknowledgement_amount": "100",
"acknowledgement_type": "Full",
"acknowledgement_narration": "Test acknowledgement",
"acknowledgment_reference": "ACK01",
"merchant_transaction_id": "TinggTestSandbox01",
"service_code": "TINGGTEST",
"status_code": "183",
"currency_code": "KES"
}
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. |