• 简体中文
  • 退款结果通知

    通知请求路径

    退款复用支付回调通知,就是“下单”接口参数notifyUrl

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

    通知请求参数

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

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

    其他注意事项

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