Cancel Payment

POST

/payments/{id}/cancel

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Responses

🟢200

application/json

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🟠409

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/payments/txn_2n1TLgiZFvF7DZuL/cancel' \
--header 'Idempotency-Key: b3ee288d-3b86-4436-b49c-681e583ff6f5' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example

{
    "data": {
        "id": "txn_2n1TLgiZFvF7DZuL",
        "type": "payment",
        "requested": {
            "amount": "1000.00",
            "currency": "XTS"
        },
        "initialized": {
            "amount": "1000.00",
            "currency": "XTS"
        },
        "processed": {
            "amount": "0.00",
            "currency": "XTS"
        },
        "refunded": {
            "amount": "0.00",
            "currency": "XTS"
        },
        "requisite": {
            "type": "card",
            "card": "4242424242424242",
            "holder": "Test User",
            "bank": "Test Bank"
        },
        "payment_url": "https://pay.casharc.pro/txn_2n1TLgiZFvF7DZuL?token=…",
        "status": "canceled",
        "status_code": "canceled_by_merchant",
        "created_at": "2026-01-01T00:21:56Z",
        "expires_at": "2026-01-01T00:22:56Z",
        "finalized_at": "2026-01-01T00:34:12Z",
        "metadata": {}
    }
}

Confirm Payment

Refund Payment