Cancel Payment

Cancel a pending payment

POSTCancel Payment

Endpoint URL

https://testnet.trustsig.xyz/v1/payment/cancel

Authentication Status

API Key is required for all requests Webhook Secret

Headers

x-api-key

Required

Your shop API key

x-signature

Required

HMAC-SHA256 of timestamp|method|fullUrl|body signed with your secret key, sent as 64 hex characters

How to create the signature

x-timestamp

Required

Current Unix time in milliseconds — must be the same value used to create x-signature

Parameters (Request Body)

id

string Required

Payment ID (UUID) returned when the payment was created. order_id is not accepted. Only a payment still waiting to be paid can be cancelled; a paid, expired or already cancelled payment returns an error.

Request Example

cURL

curl --location 'https://testnet.trustsig.xyz/v1/payment/cancel' \
  --request POST \
  --header 'x-api-key: $SIGNATURE_API_KEY' \
  --header 'x-signature: $SIGNATURE' \
  --header 'x-timestamp: $TIMESTAMP' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "67959536-d243-41f1-ab54-2cd83b0bd437"
}'

Response Example

200 OK Response

{
    "success": true,
    "message": "Payment cancelled successfully",
    "data": {
        "id": "67959536-d243-41f1-ab54-2cd83b0bd437",
        "status": "cancelled",
        "cancelled_at": "2024-01-15T10:30:00Z"
    }
}