Webhook

webhook 负载

每个支付 webhook 都是一个 JSON 请求体，包含顶层事件信封和用于描述支付的 data 对象。所有支付事件使用相同的结构；只有 event_type 和支付字段会发生变化。

示例负载

{
  "event_id": "9d96b4b9-27b8-4677-8615-5e16d689d596",
  "event_type": "SUCCESS",
  "created_at": "2026-08-24T10:00:00.000Z",
  "data": {
    "ref_id": "XPABC123",
    "order_id": "merchant-order-123",
    "description": "Annual membership",
    "status": "SUCCESS",
    "amount": 500,
    "currency": "INR",
    "utr": "312482855519",
    "customer_name": "Asha Sharma",
    "customer_email": "[email protected]",
    "created_at": "2026-08-24T09:50:00.000Z",
    "completed_at": "2026-08-24T10:00:00.000Z",
    "expires_at": "2026-08-24T10:00:00.000Z"
  }
}

字段

字段

类型

event_id

UUID 字符串

event_type

支付事件名称之一

created_at（顶层）

ISO-8601 时间戳

data.ref_id

字符串

data.order_id

字符串或 null

data.description

字符串或 null

data.status

支付状态

data.amount

数字；以整卢比表示

data.currency

始终为 INR

data.utr

字符串或 null

data.customer_name

字符串或 null

data.customer_email

字符串或 null

data.created_at

ISO-8601 时间戳

data.completed_at

ISO-8601 时间戳或 null

data.expires_at

ISO-8601 时间戳

请求标头

每次传送都包含这些标头。使用 X-Xenonpay-Event-Id 对重试传送进行去重。

Content-Type: application/json
X-Xenonpay-Event: SUCCESS
X-Xenonpay-Event-Id: 9d96b4b9-27b8-4677-8615-5e16d689d596

配置签名密钥后，我们还会发送 X-Xenonpay-Signature。请参阅“验证 webhook 签名”。

负载绝不包含会话令牌、客户电话号码、付款方 IP、银行账户详细信息或支付凭证。

这对您有帮助吗？
这对您有帮助吗？