Payments

Decline a payment request

Declines an incoming WhatsApp payment request through the WUTS gateway by referencing the original request's message key.

POST
/payment/decline

Declines an incoming 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/decline" \  -H "Content-Type: application/json" \  -d '{    "to": "5511999999999",    "request_message_key": "3EB0XXXX1234567890ABCDEF"  }'
{  "success": true,  "message_id": "3EB0XXXXDECLINE0123456",  "timestamp": "2026-06-15T12:37:00Z",  "message": "Payment request declined successfully"}
{  "error": "Invalid recipient JID: empty recipient"}
{  "error": "unauthorized"}
{  "error": "Failed to decline payment request: timeout"}

Cancel a payment request POST

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

Request a payment POST

Sends a WhatsApp payment request message to a recipient through the WUTS gateway, asking them to pay a given amount in a supported ISO 4217 currency. The amount is supplied in the smallest currency unit (e.g. cents) and an optional expiry timestamp defaults to 7 days from now.