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!