The Refund API makes it possible for you to refund a customer associated with a transaction either partially or in full. You can refund both mobile money and card payments.  Note that, although mobile money refunds are instant, card refunds can take up to 10 days to reflect in the customer’s bank account.

See sample mobile money refund request body below:

POST /merchants/HMXXXXXXXX/transactions/refund HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Basic endjeOBiZHhza250cG4=
Cache-Control: no-cache

  "TransactionId": "e8erU8Y383Uilfwrnv",
  "Reason": "Over paid for the item",
  "ClientReference": "39UyW83iu84",
  "Description": "description here",
  "Amount": 0.5,
  "Full": true

To refund a card transaction you can email with payment and card details. You will receive an email notification on the status of your refund API request. 

Did this answer your question?