Skip to main content
WEBHOOK
payment.completed
{
  "webhook_id": "<string>",
  "url": "<string>",
  "event": "payment.completed",
  "resource_id": "<string>",
  "payload": {
    "id": "<string>",
    "organization_id": "<string>",
    "provider_id": "<string>",
    "currency": "BITCOIN",
    "price": "<string>",
    "status": "PENDING",
    "created_at": "<string>",
    "happened_at": "<string>",
    "idempotency_key": "<string>",
    "invoice_id": "<string>",
    "price_usd": "<string>",
    "updated_at": "<string>",
    "provider": {
      "id": "provider_base_ethereum",
      "provider": "CRYPTO",
      "network": "BASE",
      "gateway": "ETHEREUM",
      "type": "native",
      "filters": [
        "evm"
      ],
      "metadata": {
        "decimals": 123,
        "contract_address": "<string>",
        "detection_min_amount": 123,
        "network_logo": "<string>",
        "gateway_logo": "<string>"
      }
    }
  },
  "timestamp": "<string>"
}

Headers

​
X-Webhook-Signature
string
required

Signature of the webhook event payload, used for verification.

​
X-Webhook-Timestamp
string
required

Timestamp of the webhook event, used to prevent replay attacks.

Example:

"2025-08-20 20:56:36.456"

​
X-Webhook-Event
string
required

The type of event being sent.

Example:

"payment.created"

Body

application/json
​
webhook_id
string
required

Unique identifier for the webhook

Example:

"webhook_0197c59c-547f-7588-9f4c-8ddca9237cd0"

​
url
string<uri>
required

URL where webhook events will be sent

Example:

"https://webhook-handler.com/webhooks"

​
event
enum<string>
required

Type of webhook event that occurred

Available options:
payment.completed
Example:

"payment.completed"

​
resource_id
string
required

Completed Payment identifier

Example:

"payment_01979449-dc2f-71e4-b565-42d78c0d83aa"

​
payload
object
required

Details of the Payment that was completed

Example:
{
  "id": "payment_01979449-dc2f-71e4-b565-42d78c0d83aa",
  "idempotency_key": "1b70f35483e563e009967abe74308e6977f9b36f1bfc05168fa22104b64293d6-invoice_01979284-7610-79f8-86c4-978168730054",
  "organization_id": "org_01972206-5a87-7c27-bad2-a6cf669a0a91",
  "provider_id": "provider_solana_usdc",
  "invoice_id": "invoice_01979284-7610-79f8-86c4-978168730054",
  "currency": "BITCOIN",
  "price": "0.000126300000000000000000000000",
  "price_usd": "13.2750000000000000000000000000",
  "status": "COMPLETED",
  "created_at": "2025-07-04 18:10:53",
  "updated_at": "2025-07-04 18:15:23",
  "happened_at": "2025-07-04 18:15:20"
}
​
timestamp
string
required

Timestamp when the event occurred

Example:

"2025-08-20 20:56:36.456"