跳转到内容
PGSwift Docs
文档/出款完成 Webhook

出款完成 Webhook

POST 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.completed"
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.transfer_type string 本次出款实际使用的转账类型:"bifast" 或 "rtol"
data.account_name string 收款账户持有者的姓名
data.valid_account_name string 银行验证后的收款账户持有者姓名
data.account_number string 收款人的账户号码
data.status string 状态:"success"
data.reason string/null 失败原因(例如 "Inquiry expired")。出款成功时始终为 null
data.similarity_score integer/null 请求中的姓名与银行返回的账户持有人姓名之间的相似度分数,0 到 100。银行未返回姓名时为 0。您的账户未开启姓名校验或分数未被记录时为 null
data.trigger_source string/null 姓名校验由谁决定:auto_approve、auto_reject(Enforce 模式;reason 为 Rejected)、admin_telegram 或 admin_dashboard。查询仍被扣留(等待审核或触发金额阈值)、未经决定即过期,或 similarity_score 为 null 时为 null。参见付款查询
data.payment_at string/null 付款完成时间戳(ISO 8601 格式),未付款时为 null
data.created_at string 查询创建的时间戳(ISO 8601 格式)
data.updated_at string 最后更新的时间戳(ISO 8601 格式)

示例负载

{
  "event": "disbursement.v2.completed",
  "timestamp": "2025-01-10T00:54:48+07:00",
  "data": {
    "id": "01jhnbppe78v0xew39r402nk0w",
    "merchant_transaction_id": "RLG00000000",
    "amount": "25000.00",
    "bank_code": "002",
    "bank_name": "Bank Rakyat Indonesia",
    "transfer_type": "bifast",
    "account_name": "John Doe",
    "valid_account_name": "JOHN D**",
    "account_number": "0000000000",
    "status": "success",
    "reason": null,
    "payment_at": "2025-01-10T00:54:46+07:00",
    "created_at": "2025-01-10T00:54:42+07:00",
    "updated_at": "2025-01-10T00:54:48+07:00"
  }
}