Payments

Send a payment notification

Sends a WhatsApp payment-sent notification through the WUTS gateway, referencing the original payment request by its message key to inform the recipient that the payment has been made.

POST
/payment/send

Sends a WhatsApp payment-sent notification through the WUTS gateway, referencing the original payment request by its message key to inform the recipient that the payment has been made.

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/send" \  -H "Content-Type: application/json" \  -d '{    "to": "5511999999999",    "request_message_key": "3EB0XXXX1234567890ABCDEF",    "currency": "BRL",    "amount": 15000,    "note_message": "Payment for invoice #4521"  }'
{  "success": true,  "message_id": "3EB0XXXX9876543210FEDCBA",  "timestamp": "2026-06-15T12:35:10Z",  "message": "Payment notification sent successfully"}
{  "error": "WhatsApp not connected"}
{  "error": "unauthorized"}
{  "error": "Failed to send payment notification: timeout"}

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.

Application Prometheus metrics GET

Exposes the WUTS application metrics in Prometheus text exposition format on an isolated registry: Go runtime stats, process collector stats, and webhook delivery counters and histograms. Intended for internal scraping and requires no authentication.