• 简体中文
  • 支付结果通知

    通知请路径
    请求路径就是“下单”接口中的参数notifyUrl

    notifyUrlString200是交易结果回调地址,用于接收交易结果信息变更的消息通知http://aaa.bbb.ccc/notifyUrl/

    通知请求参数

    参数类型长度必填描述
    orderIdString32是商户唯一订单号,可用于查询交易结果
    orderNoString32是PalmPay平台订单号
    appIdString32是商户APPID
    currencyString10是货币代码(NGN、GHS、TZS、KES、ZAR)
    amountLong-是交易金额(最小单位计量)
    orderStatusInteger20是订单状态(见订单状态)
    completeTimeTimestamp-否交易完成时间
    signString200是签名:非空参数值的参数,按签名方法,用平台公钥验签
    payerString-否JSON string格式,详见:付款人信息(Payer)(白名单商户返回此域,如需请联系BD申请)
    payMethodString-否订单支付方式

    Postman示例

    {
        "orderId":"41220723093001",
        "orderNo":"e7c3784d5e2242fc00afe89ac1234",
        "appId":"AppId123456",
        "currency":"NGN",
        "amount":200000,
        "orderStatus":1,
        "completeTime":1658574095184,
        "sign":"IDjwDpLTJXqbJh0PmC74R0HuEBM7oIpHdmfnIn6V14%2Bh2hZaUZCf1cbHR8M%3D"
    }

    注意收到的sign需要 URLDecoder.decode(sign,"UTF-8")解码获得 原始信息

    其他注意事项

    1. notify回调通知的响应

    必须返回明确的结果,HTTP响应码应为 200,并且返回指定字符串:success(非json格式,不包含其他符号的纯字符串);若返回其他结果,会触发8次重试。重试间隔为:5s,
    30s, 4m, 10m, 1h, 2h, 6h, 15h。

    1. 实际收到的notify参数

    实际收到的请求参数可能包含更多字段(用于兼容历史版本),所有字段都会参与签名验证。建议使用Map结构接收全部参数并验证签名,使用参数时请以上述通知请求参数表为准。