• English
  • Notification of Payment Result

    Request Path

    The request path is the notifyUrl parameter from the "Create Order" interface.

    notifyUrlstring200yesThe callback URL for transaction results, used to receive notifications of changes in transaction resultshttp://aaa.bbb.ccc./notifyUrl/

    Notification Request Parameters

    NameTypeLengthRequiredDescription
    outOrderNoString32YesMerchant order number, customized by the merchant, up to 32 characters, supports letters, numbers, underscores, and must be unique within the merchant system
    orderNoString32YesPalmPay platform order number
    appIdString32YesMerchant APP ID
    amountLong-YesTotal order amount (unit: cents)
    rechargeAccountString15NoRecharge account
    orderStatusInteger20YesOrder status (For details, see Order Status)
    completedTimeTimestamp-YesTransaction completion time
    signString200YesSignature: The concatenated string of non-empty parameter values, signed using the signature method with the platform's public key
    errorMsgString200NoError message

    Postman Example

    {
       "outOrderNo": "sk32xTpXZDRm4w34aWjk8eHHnKsAzdXW",
       "orderNo": "y521r664000",
       "appId": "L240327085486621407421",
       "amount": 30000,
       "rechargeAccount": "023408164307637",
       "orderStatus": 3,
       "country": "NG",
       "sign": "P2ZsF6ihaXhERkEncCHw5OP16hg3kZesDeS%2BOzsk2OoxtkAGHaGchRpd2myeZBjV48w9%2BAlF54THZXidvbxOlQPWPs5N5YYZRc2iOHKiXjsou5DnhHzdvwgNYkbcwIjn4cJJxF5HePhc%2B%2FEBQhJr%2BiNEvmPwdIKKem65MV9n7oI%3D"
    }

    Note: The received 'sign' needs to be decoded to obtain the original information using URLDecoder.decode(sign, "UTF-8").

    Other Considerations

    1. Response to notify callback notification
      The response must be explicit, with an HTTP response code of 200, and the response should be the specified string: "success" (in a plain text format, a pure string without other symbols). if returns other results, 8 retries will be triggered. The retry interval is: 5s, 30s, 4m, 10m, 1h, 2h, 6h, 15h.