Update a Successful Payment Status
POST /payments/card/status-successful
Description
Update the status of a payment made via a card to indicate a successful transaction.
Query Parameters
| Name | Type | Description |
|---|---|---|
| object* | object | (Required) An object representing the card payment details. |
Request Body
- Media Type:
application/atom+xml
Example
cURL
curl --location 'http://20.87.230.105/platform/wallets/payments/card/status-successful' \
--header 'apiKey: yourApiKey' \
--header 'Content-Type: application/xml' \
--header 'Authorization: Bearer yourAccessToken' \
--data '
<comment class='preserveHtml' class='preserveHtml' class='preserveHtml'> The XML structure representing the card payment details goes here -->'
Success Response (200)
The Success Response (200) is returned when the USSD payment request is successfully initiated.
Response Fields
| Field | Type | Description |
|---|---|---|
| status | boolean | Indicates the success of the USSD payment request. |
| statusCode | integer | Numeric code representing the status of the response (e.g., 0 for success). |
| message | string | A message indicating the outcome of the operation. |
| data | object | An empty object, as no additional data is returned in a successful response. |
| errors | array | An array of objects providing details about any errors encountered during the request. |
Example
XML:
<comment class='preserveHtml' class='preserveHtml'> XML example cannot be generated; root element name is undefined -->
Method: POST
>http://20.87.230.105/platform/wallets/payments/card/status-successful
Headers
| Content-Type | Value |
|---|---|
| apiKey | {{apiKey}} |
Body (raw)
<?xml version="1.0" encoding="UTF-8"?>
<!-- The XML structure representing the card payment details goes here -->
🔑 Authentication bearer
| Param | value | Type |
|---|---|---|
| token | {{accessCode}} | string |
LANGUAGE
CURL REQUEST
curl --request POST \
--url /payments/card/status-successful \
--header 'accept: application/json' \
--header 'content-type: application/json'
RESPONSE
Click Try It! to start a request and see the response here!