出款失败 Webhook · PGSwift Docs

POST disbursement.v2.fail

此事件在出款失败时独立触发。不会与 disbursement.v2.completed 重叠 — 每个事件根据结果独立触发。

请求头

所有 webhook 请求都包含以下请求头，用于身份验证和验证：

请求头	描述
X-PARTNER-ID	您的客户端标识符
X-TIMESTAMP	请求时间戳，采用 ISO8601 格式 (e.g., 2024-12-18T16:21:07+07:00)
X-SIGNATURE	用于请求验证的 RSA 签名（参见签名生成）

负载结构

名称	类型	描述
event	string	事件名称："disbursement.v2.fail"
timestamp	string	事件时间戳（ISO 8601 格式）
data	object	出款明细
data.id	string	查询 ID（唯一标识符）
data.merchant_transaction_id	string	客户为商户提供的唯一标识符
data.amount	string	交易的总金额
data.bank_code	string	银行代码（例如 "014"、"002"）
data.bank_name	string	处理该交易的银行名称
data.account_name	string	收款账户持有者的姓名
data.valid_account_name	string	银行验证后的收款账户持有者姓名
data.account_number	string	收款人的账户号码
data.status	string	状态："fail"
data.reason	string/null	失败原因（例如 `"Inquiry expired"`）。出款成功时为空或 null
data.payment_at	string/null	付款完成时间戳（ISO 8601 格式），未付款时为 null
data.created_at	string	查询创建的时间戳（ISO 8601 格式）
data.updated_at	string	最后更新的时间戳（ISO 8601 格式）

示例负载

{
  "event": "disbursement.v2.fail",
  "timestamp": "2025-01-10T00:54:48+07:00",
  "data": {
    "id": "01jmmtbfcthj8y0eg3w1he4q3t",
    "merchant_transaction_id": "RLG00000000",
    "amount": "25000.00",
    "bank_code": "002",
    "bank_name": "Bank Rakyat Indonesia",
    "account_name": "John Doe",
    "valid_account_name": "JOHN D**",
    "account_number": "0000000000",
    "status": "fail",
    "reason": "Destination account is invalid, please verify or try a different destination account",
    "payment_at": null,
    "created_at": "2025-01-10T00:54:42+07:00",
    "updated_at": "2025-01-10T00:54:48+07:00"
  }
}