• 简体中文
  • 补单结果通知

    当发生订单冲正时(商户已收到失败通知,但外部实际状态为成功),PalmPay 会生成补单为商户入账,确保待结算金额计入商户余额。商户可根据补单通知中的订单信息为用户履约。

    通知地址

    通知地址在 API Key–AppID 详情页的 Webhook 字段中配置。

    参数类型长度必填描述示例
    notifyUrlString200是补单结果通知,用于在订单冲正后接收补单结果。http://aaa.bbb.ccc/notifyUrl/

    通知请求参数

    参数类型长度必填描述
    orderNoString32是补单单号
    appIdString32是商户应用 ID
    currencyString10是货币代码(GHS、TZS、KES、ZAR、PKR)
    amountLong-是交易金额(最小单位)
    orderStatusInteger20是订单状态
    feeLong-是交易手续费
    remarkString200否备注
    createdTimeTimestamp-是交易创建时间
    completedTimeTimestamp-是交易完成时间
    originalOrderNoString32是关联的原始 PalmPay 平台单号

    Postman 示例

    {
        "orderNo": "variance27127no1",
        "appId": "AppId123456",
        "currency": "GHS",
        "amount": 200000,
        "orderStatus": 1,
        "fee": 30,
        "remark": "test",
        "createdTime": 1658574094242,
        "completedTime": 1658574095184,
        "originalOrderNo": "24261022231735560286"
    }