• English
  • Notification of Payment Result

    Payment Result Notification

    The request path is the notifyUrl parameter in the order creation interface

    notifyUrlstring200yesReceive transaction notification urlhttp://aaa.bbb.ccc./notifyUrl/

    Notification Request Parameters

    NameTypeLengthRequiredDescription
    orderIdString32yesThe unique Order Number of the merchant, which can be used to query transaction results.
    orderNoString32yesPalmPay platform Order No.
    appIdString32yesPalmPay merchant APP ID
    currencyString10yesCurrency (NGN)
    amountLong-yesTransaction amount (minimum unit measurement)
    orderStatusLong20yesOrder Status(see Order Status)
    sessionIdString128NoChannel Response Parameters. Note: Most of the non-NIBSS channels do not return sessionId, if there is any problem with this type of order, you need to provide the order number to PalmPay to confirm the actual arrival of the payee.
    completeTimeTimestamp32noTransaction completion time
    errorMsgString-noorder errorMsg, Not required
    signString200yesSignature: Parameters with non-null parameter values are verified with the platform public key according to the signature method

    Request Example

    {
        "orderId":"41220723093001",
        "orderNo":"e7c3784d5e2242fc00afe89ac1234",
        "appId":"AppId123456",
        "currency":"NGN",
        "amount":200000,
        "orderStatus":2,
        "sessionId": "100033240509135230000500932911",
        "completeTime":1658574095184,
        "sign":"IDjwDpLTJXqbJh0PmC74R0HuEBM7oIpHdmfnIn6V14%2Bh2hZaUZCf1cbHR8M%3D"
    }

    Note that the received sign must be decoded URLDecoder.decode(sign,"UTF-8") to obtain the original information.

    Other Considerations

    1. notify callback notification response
      Must return a clear result, the HTTP response code should be 200, and return the specified string: success (non-json format, does not contain other symbols of the plain string); if returns other results, 8 retries will be triggered. The retry interval is: 5s, 30s, 4m, 10m, 1h, 2h, 6h, 15h.