Cancel payments

POST

/refund

Product in beta version 🔐
We are working on our beta version. Stay tuned for its official release! You can also contact your account manager for more information.

Perform cancellations of previously authorized transactions through this service. Once a cancellation is approved, the funds will be returned to your client's card.

Note: the time for funds to be reflected in the cardholder's account will depend on the issuing bank.

Send the original transaction id to request a cancellation. You can make partial cancellations by sending an amount less than the transaction amount.

To cancel a transaction, the following conditions must be met:

The original transaction must be approved at least 1 minute ago.

The request must be made before 11 p.m. (CDMX time) on the same day the original transaction was made.

The cancellation must be for an amount equal to or less than the original transaction.

See the full list of error codes.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Bodyapplication/json

🟠400

🟠401

🟠404

Request Example

Shell

JavaScript

Java

Swift

cURL

Partial cancellationPayment cancellation

curl --location 'https://api-uat.kushkipagos.com/refund' \
--header 'X-BP-AUTH;' \
--header 'Content-Type: application/json' \
--data '{
    "saleId": "12345",
    "refundAmount": 200
}'

Response Example

200 - Approved

{
    "message": {
        "statusInfo": "APROBADA",
        "status": "1",
        "transactionId": "129058",
        "autorization": "BP0701"
    },
    "statusCode": 200,
    "error": null
}

Modified at 2026-07-10 20:44:17

Cancel payments Error Codes

API Raw Card Present

Cancel payments

Product in beta version 🔐#

Request

Responses

Product in beta version 🔐