Refund callback

If you have configured callbacks, pawaPay will POST a callback to your configured callback URL for each refund when it reaches a final status. Read more about handling callbacks and callback URLs.

If you have not configured callbacks, you can always call our Check Refund Status endpoint to get the latest status and details of a specific refund request.

Headers

Following headers are only included if you have enabled signed callbacks.

Read more about how to implement signed callbacks.

Content-Digest

string

SHA256 or SHA-512 hash of the request body.

Signature

String

Signature of the request according to RFC-9421.

Signature-Input

String

Signature input according to RFC-9421.

Signature-Date

String

Timestamp when signature was created. This is a custom field and is not part of RFC-9421.

Accept-Signature

String

Expected signature algorithm of the response according to RFC-9421.

Accept-Digest

String

Expected digest algorithm of the response according to RFC-9421.

Body

The schema is of type object.

Resend refund callback Deposit via Payment Page

{
  "refundId": "f4401bd2-1568-4140-bf2d-eb77d2b2b639",
  "status": "COMPLETED",
  "amount": "15",
  "currency": "ZMW",
  "country": "ZMB",
  "correspondent": "MTN_MOMO_ZMB",
  "recipient": {
    "type": "MSISDN",
    "address": {
      "value": "260763456789"
    }
  },
  "customerTimestamp": "2020-02-21T17:32:28Z",
  "statementDescription": "Note of 4 to 22 chars",
  "created": "2020-02-21T17:32:29Z",
  "receivedByRecipient": "2020-02-21T17:32:30Z",
  "correspondentIds": {
    "MTN_INIT": "ABC123",
    "MTN_FINAL": "DEF456"
  },
  "failureReason": {
    "failureCode": "OTHER_ERROR",
    "failureMessage": "Recipient's address is blocked"
  },
  "metadata": {
    "orderId": "ORD-123456789",
    "customerId": "customer@email.com"
  }
}

Deposits

Payouts

Refunds

Payment page

Wallet balances

Toolkit

Headers

Body

Deposits

Payouts

Refunds

Payment page

Wallet balances

Toolkit

​Headers

​Body

Headers

Body