• 简体中文
  • 入金订单通知

    通知请求路径

    入金订单通知回调地址,请在Web Business -> Pay-In -> Virtual Account -> Webhook中配置

    通知请求参数

    名称类型长度必填描述
    orderNoString32是PalmPay平台订单号
    orderStatusInteger3是Virtual Account订单状态 ● 状态枚举见 Virtual Account订单状态
    createdTimeLong13是订单创建时间
    updateTimeLong13是订单修改时间
    currencyString3是订单货币(虚拟账号服务目前只包含NGN) ● 货币代码字典见 货币字典
    orderAmountLong19是订单金额即外部转账的发起金额,精确到分
         
    referenceString512否付款方备注
    payerAccountNoString64是付款方账户号码
    payerAccountNameString200是付款方账户名称
    payerBankNameString64是付款方银行
    virtualAccountNoString64否虚拟账号的号码(只有向虚拟账号入金才会返回,向商户主账户入金不会返回)
    virtualAccountNameString200否虚拟账号的名称(只有向虚拟账号入金才会返回,向商户主账户入金不会返回)
    accountReferenceString120否This is a reference field for the virtual account.
    sessionIdString128否渠道响应参数,注:大部分非NIBSS通道不返回sessionId,此类订单若有问题需提供订单号找PalmPay和银行确认用户实际到账情况
    signString200否Signature: Parameters with non-null parameter values are verified with the platform public key according to the Signature method

    其他注意事项

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