Skip to main content

Update a Failed Payment Status

POST /payments/card/status-failed

Description​

Update the status of a payment made via a card to indicate a failed transaction.

Query Parameters​

NameTypeDescription
object*object(Required) An object representing the card payment details.

Request Body​

  • Media Type: application/atom+xml

Example

Success Response (200)​

The Success Response (200) is returned when the USSD payment request is successfully initiated.

Response Fields​

FieldTypeDescription
statusbooleanIndicates the success of the USSD payment request.
statusCodeintegerNumeric code representing the status of the response (e.g., 0 for success).
messagestringA message indicating the outcome of the operation.
dataobjectAn empty object, as no additional data is returned in a successful response.
errorsarrayAn array of objects providing details about any errors encountered during the request.

Example​

XML:

<comment class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;> XML example cannot be generated; root element name is undefined  -->

Method: POST​

>http://20.87.230.105/platform/wallets/payments/card/status-failed

Headers​

Content-TypeValue
apiKey{{apiKey}}

Body (raw)​

<?xml version="1.0" encoding="UTF-8"?>
<!-- The XML structure representing the card payment details goes here -->

🔑 Authentication bearer​

ParamvalueType
token{{accessCode}}string

LANGUAGE

AUTHORIZATION

Bearer

CURL REQUEST


curl --request POST \ 
--url /payments/card/status-failed \
--header 'accept: application/json' \
--header 'content-type: application/json'

RESPONSE


Click Try It! to start a request and see the response here!