Payments

Cancel a payment request

Cancels a previously sent WhatsApp payment request through the WUTS gateway by referencing the original request's message key.

POST
/payment/cancel

Cancels a previously sent WhatsApp payment request through the WUTS gateway by referencing the original request's message key.

Authorization

bearerAuth
AuthorizationBearer <token>

Per-user API token (UUID v4) sent as Authorization: Bearer <token>. Identifies the tenant and user.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/payment/cancel" \  -H "Content-Type: application/json" \  -d '{    "to": "5511999999999",    "request_message_key": "3EB0XXXX1234567890ABCDEF"  }'
{  "success": true,  "message_id": "3EB0XXXXCANCEL01234567",  "timestamp": "2026-06-15T12:36:00Z",  "message": "Payment request cancelled successfully"}
{  "error": "Invalid recipient JID: empty recipient"}
{  "error": "unauthorized"}
{  "error": "Failed to cancel payment request: timeout"}