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

    通知请求路径

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

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

    通知请求参数

    参数类型长度必填说明
    orderIdString32是商户唯一订单号,可用于查询交易结果
    orderNoString32是PalmPay platform 平台订单号
    appIdString32是商户APP ID
    currencyString10是货币代码(NGN、GHS、TZS、KES、ZAR)
    amountLong-是交易金额 (最小单位计量)
    orderStatusLong20是订单状态(见订单状态)
    sessionIdString128否渠道响应参数,注:大部分非NIBSS通道不返回sessionId,此类订单若有问题需提供订单号找PalmPay和银行确认用户实际到账情况
    completeTimeTimestamp32noTransaction completion time
    errorMsgString-否订单错误信息,非必有
    signString200是签名:非空参数值的参数,按签名方法用平台公钥验签

    Postman 示例

    {
        "orderId":"41220723093001",
        "orderNo":"e7c3784d5e2242fc00afe89ac1234",
        "appId":"AppId123456",
        "currency":"NGN",
        "amount":200000,
        "orderStatus":2,
        "sessionId": "100033240509135230000500932911",
        "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。