• English
  • Notification of payment result

    Payment result notification

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

    ParameterTypeLengthRequiredDescriptionExample
    notifyUrlString200yesTransaction result callback address for receiving message notifications of changes to transaction result informationhttp://aaa.bbb.ccc/notifyUrl/

    Notification request parameter

    ParameterTypeLengthRequiredDescription
    orderIdString32yesThe merchant's unique order number can be used to check transaction results
    orderNoString32yesPalmPay platform order number
    appIdString32yesMerchant AppId
    currencyString3yesCurrency(NGN) Data Dictionary
    amountLong-yesTransaction amount(min unit)
    orderStatusInteger20yesOrder status
    completeTimeTimestamp-NoTransaction closing time
    signString200yesSignature: Parameters with non-null parameter values are verified with the platform public key according to the signature method
    payerString-NoPayerInfo (Only return to merchant in Whitelist,Please kindly ask BD to Apply if needed.)
    payMethodString-NoPayment method

    Request example

    {
        "orderId":"41220723093001",
        "orderNo":"e7c3784d5e2242fc00afe89ac1234",
        "appId":"AppId123456",
        "currency":"NGN",
        "amount":200000,
        "orderStatus":1,
        "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.