补单结果通知
当发生订单冲正时(商户已收到失败通知,但外部实际状态为成功),PalmPay 会生成补单为商户入账,确保待结算金额计入商户余额。商户可根据补单通知中的订单信息为用户履约。
通知地址
通知地址在 API Key–AppID 详情页的 Webhook 字段中配置。
当发生订单冲正时(商户已收到失败通知,但外部实际状态为成功),PalmPay 会生成补单为商户入账,确保待结算金额计入商户余额。商户可根据补单通知中的订单信息为用户履约。
通知地址在 API Key–AppID 详情页的 Webhook 字段中配置。
| 参数 | 类型 | 长度 | 必填 | 描述 | 示例 |
|---|---|---|---|---|---|
| notifyUrl | String | 200 | 是 | 补单结果通知,用于在订单冲正后接收补单结果。 | http://aaa.bbb.ccc/notifyUrl/ |
| 参数 | 类型 | 长度 | 必填 | 描述 |
|---|---|---|---|---|
| orderNo | String | 32 | 是 | 补单单号 |
| appId | String | 32 | 是 | 商户应用 ID |
| currency | String | 10 | 是 | 货币代码(GHS、TZS、KES、ZAR、PKR) |
| amount | Long | - | 是 | 交易金额(最小单位) |
| orderStatus | Integer | 20 | 是 | 订单状态 |
| fee | Long | - | 是 | 交易手续费 |
| remark | String | 200 | 否 | 备注 |
| createdTime | Timestamp | - | 是 | 交易创建时间 |
| completedTime | Timestamp | - | 是 | 交易完成时间 |
| originalOrderNo | String | 32 | 是 | 关联的原始 PalmPay 平台单号 |
{
"orderNo": "variance27127no1",
"appId": "AppId123456",
"currency": "GHS",
"amount": 200000,
"orderStatus": 1,
"fee": 30,
"remark": "test",
"createdTime": 1658574094242,
"completedTime": 1658574095184,
"originalOrderNo": "24261022231735560286"
}