Virtual Account Services
  1. Refund
Virtual Account Services
  • Introduction
  • Terminologies
  • Webhooks
  • Authentication
  • Account
    • Create Account
      POST
    • Rename Account
      POST
    • Balance Inquiry
      GET
    • Create Bulk Accounts
      POST
    • List Accounts
      GET
  • Transaction
    • Credit Account
      POST
    • Debit Account
      POST
    • Credit Account [Agency Banking]
      POST
    • Debit Account [Agency Banking]
      POST
    • Transaction Query
      GET
    • Transaction Details
      GET
    • Transaction History
      GET
  • Transfer
    • Get Institutions
      GET
    • Name Inquiry
      POST
    • Interbank Transfer
      POST
    • Interbank Transfer [Sync]
      POST
    • Transfer Query
      GET
    • Transfer Enquiry
      GET
    • Virtual Account Intrabank Transfer
      POST
    • Core Banking Intrabank Transfer
      POST
    • Collection Accounts Intrabank Transfer
      POST
  • Invoice
    • Create Invoice
    • Get Invoice Detail
    • List Merchant Invoices
  • Refunds
    • Initiate Refund
    • Get Refund Status
    • Get Refunds
  • Notifications
    • Notification
    • Send Notification
  • Merchant
    • Account
      • Get Account
      • Activate Sub Ledger For Merchant
      • Get SubLedger Callback Urls
      • Set SubLedger Callback Urls
      • Get Collection Accounts
    • Transfer
      • Get Transfer History
      • Get Subledger transfers
      • Get Transfer Details
      • Name Inquiry
    • Refund
      • Refund Details
        GET
  • Admin
    • Accounting
      • Get GL Accounts
      • Get Classification Codes
    • Dashboard
      • Dashboard Summary
      • Dashboard Transactions
      • Dashboard Transaction Details
    • Group Codes
      • Get Group Codes
      • Set Collection Account
      • Create Group Code
    • Reporting
      • Get Report Types
      • Get Report Parameters
      • Create Report
      • Get Reports
      • Get Reports Details
  1. Refund

Refund Details

GET
/merchant/refund/{transactionReference}
This API retrieves refund details for a specific transaction using the transactionReference provided in the URL. The response includes the total refundable amount and a history of refunds associated with the transaction.

Path Parameters#

Field NameTypeRequiredDescription
transactionReferencestringTRUEThe unique reference for the original transaction, provided in the URL.

Response Body#

Field NameTypeDescription
refundableAmountnumberThe total amount refundable for the transaction.
refundsHistoryarrayAn array of refund history objects detailing each refund.

Refund History Object#

Field NameTypeDescription
transactionReferencestringThe transaction reference associated with the refund.
refundReferencestringThe unique reference for the refund.
refundAmountnumberThe amount refunded.
refundReasonstringThe reason provided for the refund (e.g., "Order cancelled!").
customerNotestringA note from the customer regarding the refund.
refundTypestringThe type of refund (e.g., "PARTIAL_REFUND").
refundStatusstringThe current status of the refund (e.g., "COMPLETED").
refundStrategystringThe strategy used for processing the refund (e.g., "MERCHANT_WALLET").
commentstringAdditional comments regarding the refund.
completedOnstringThe timestamp when the refund was completed.
createdOnstringThe timestamp when the refund record was created.

Request

Path Params

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/merchant/refund/000004240320184906771219576423'

Responses

🟢200Refund Details
application/json
Body

Example
{
    "refundableAmount": 475,
    "refundsHistory": [
        {
            "transactionReference": "000004240320184906771219576423",
            "refundReference": "909090934",
            "refundAmount": 25,
            "refundReason": "Order cancelled!",
            "customerNote": "Invoice SubLedger Refund",
            "refundType": "PARTIAL_REFUND",
            "refundStatus": "COMPLETED",
            "refundStrategy": "MERCHANT_WALLET",
            "comment": "Transaction refund is complete.",
            "completedOn": "26/01/2024 11:18:30 AM",
            "createdOn": "26/01/2024 11:14:29 AM"
        }
    ]
}
Modified at 2025-03-17 22:20:07
Previous
Name Inquiry
Next
Get GL Accounts
Built with