Skip to main content
WEBHOOK
payment.updated
{
  "webhook_id": "<string>",
  "url": "<string>",
  "event": "payment.updated",
  "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>"
  },
  "timestamp": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.bitgpt.xyz/llms.txt

Use this file to discover all available pages before exploring further.

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_019833b9-fbc3-7ba8-ab99-c5ca0be991a6"

​
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.updated
Example:

"payment.updated"

​
resource_id
string
required

Updated Payment identifier

Example:

"payment_019833b9-fbc3-7ba8-ab99-c5ca0be991a6"

​
payload
object
required

Details of the Payment that was updated

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"