API Reference

Webhook testing

Preview and send sample payment webhooks to your callbackUrl.

When you configure a custodian callbackUrl, Argonpay sends HTTP POST requests with Content-Type: application/json on payment lifecycle events.

When webhooks fire

Event	`status` in body
Payment completed	`completed`
Payment expired	`expired`
Payment cancelled	`cancelled`

Request format

POST /your/webhook/path HTTP/1.1
Content-Type: application/json

Body fields

Field	Type	Description
`txnid`	string	Payment identifier
`status`	string	`completed`, `expired`, or `cancelled`
`amount`	number	Requested payment amount
`amountInToken`	number	Token-denominated amount
`network`	string	Chain identifier (e.g. `polygon`, `bep20`)
`createdAt`	string	Transaction creation timestamp
`secret`	string	Custodian secret (when configured)
`privateKey`	string	Same value as `secret` (legacy field name)

Verify on your server

Accept POST JSON only.
Match txnid against your order records.
Validate secret / privateKey against the secret you set on the custodian.
Treat completed as paid, expired / cancelled as terminal non-success states.

Use the webhook tester below to preview the JSON body and send a test POST to your endpoint.

Webhook preview

Test your webhook

Argonpay POSTs JSON to your custodian callbackUrl when a payment completes, expires, or is cancelled. Adjust the fields below to see the exact body shape, then optionally send a test request to your endpoint.

Status StringSent after payment is detected and settlement processing finishes.txnid Stringamount FloatamountInToken Floatnetwork Stringsecret StringAlso sent as privateKey for legacy integrations.createdAt StringcallbackUrl StringYour server endpoint — used only when you click Send test webhook.

POST body preview

{
  "txnid": "demo-txn-abc123",
  "status": "completed",
  "amount": 25.5,
  "amountInToken": 25.5,
  "network": "polygon",
  "createdAt": "2026-07-13T17:22:58.995Z",
  "secret": "your-custodian-secret",
  "privateKey": "your-custodian-secret"
}