• English
  • Make-up Order Notification

    When an order reversal occurs (the merchant has been notified of failure, but the external actual status is success), PalmPay creates a make-up order to credit the merchant, ensuring that the amount to be settled is credited to the merchant's balance. The merchant can fulfill the contract to the user based on the order information in the make-up order notification.

    Notification URL

    The notification URL is configured in the Webhook field on the API Key–AppID details page.

    ParameterTypeLengthRequiredDescriptionExample
    notifyUrlString200YesMake-up order result notification, used to receive the result of the make-up order after an order reversal.http://aaa.bbb.ccc/notifyUrl/

    Notification Request Parameters

    ParameterTypeLengthRequiredDescription
    orderNoString32YesMake-up order number
    appIdString32YesMerchant App ID
    currencyString10YesCurrency code (GHS, TZS, KES, ZAR, PKR)
    amountLong-YesTransaction amount (in the smallest unit)
    orderStatusInteger20YesOrder status
    feeLong-YesTransaction fee
    remarkString200NoRemark
    createdTimeTimestamp-YesTransaction creation time
    completedTimeTimestamp-YesTransaction completion time
    Original Order NoString32YesRelated original PalmPay platform order number

    Postman Example

    {
        "orderNo": "variance27127no1",
        "appId": "AppId123456",
        "currency": "GHS",
        "amount": 200000,
        "orderStatus": 1,
        "fee": 30,
        "remark": "test",
        "createdTime": 1658574094242,
        "completedTime": 1658574095184,
        "originalOrderNo": "24261022231735560286"
    }