• 简体中文
  • PayOut 安全验证

    Payout 安全验证是针对商户的 Payout 请求 PalmPay 会再向商户发起二次确认,商户在接收到二次确认通知时要给出通过、拒绝的反馈。只有商户二次确认通过的订单PalmPay 才会继续执行出金动作,否则会置订单为失败。

    逻辑说明

    image.png

    通知请求路径

    Webhook地址,商户开启安全验证时配置的 Webhook 地址,用于接收 PalmPay 的Payout二次确认的通知。

    通知参数

    参数类型长度必填说明
    orderNoString200是PalmPay返回的订单号
    orderIdString200是商户原始订单号
    currencyString200是币种
    amountLong-是订单金额
    payeeNameString50是收款方姓名
    payeeBankCodeString50是收款方银行编码
    payeeBankAccNoString50是收款方账号
    notifyUrlString200是接收代付结果通知 URL

    Postman请求示例

    商户接收到来自 PalmPay 的出金安全验证通知需要先进行验签然后确认,并需要返回approve(通过)/ reject (拒绝)。

    curl -X POST 'https://xxxx' \
      -H 'Content-Type: application/json' \
      --max-time 3 \
      -d '{
        "orderNo": "41261103050021760723",
        "orderId": "mcone4358-auto-504fa7ab",
        "currency": "NGN",
        "amount": 15000,
        "payeeName": "test",
        "payeeBankCode": "100033",
        "payeeBankAccNo": "1234567890",
        "notifyUrl": "https://xxx",
        "sign": "aZdHgVsnXsqvC%2FLLL5NBv6tyWCuJC77bKUkkWBiIvtgmSB8c3VFnijj7IwKFNtaEo6sv66W9%2BRgPisa3cNp8sFTJNXAukOTjydqR5gxhVUSYilJhggiK8xbwfOKc283I2Q5Z9u3FhxxnLxn4xdAcmiotoBOpX6oXCpqV6icFYfc%3D"
      }'

    注:商户接收到出金请求通知后需要在 3s 内给出approve/reject反馈,超时也会判定为无效,订单会置为失败