Refund
Fields
linksobject requiredLinks related to this resource.
selfstring uri requiredThe unique URI to this resource.
cancelstring
idstring uuid requiredThe unique identifier for this refund.
transactionIdstring uuid requiredThe transactions identifier of the payment that is being refunded.
The refund amount.
Fields of
Amountcurrencystring requiredThe ISO 4217ISO 4217 The three-letter currency codes, such as
ZARfor the South African rand. Always uppercase.Wikipedia current code.min length3max length3valuenumber float requiredThe amount in the currency specified.
min0.01
requestedstring date-time requiredThe date and time the refund was requested.
completedstring date-timeThe date and time the refund was completed.
statusstring requiredThe refund status. Possible values are:
- Pending - The refund request has been submitted and accepted.
- Complete - The refund has been paid successfully.
- Submitted - The refund has been assigned to a batch and is being processed.
- Failed - The refund payment has failed.
- Cancelled - The refund has been cancelled before it was submitted.
- Returned - The refund payment has been returned because the account that was being refunded no longer exists.
values"Pending""Complete""Submitted""Failed""Cancelled""Returned"reasonstringThe reason for the status of the refund.
paidToRefundPaidToThe bank details of where the refund was paid to.
Fields of
RefundPaidToaccountNumberstring requiredThe bank account number the refund was paid into.
institutionstring requiredThe display name of the institution holding the account.
branchCodestring nullableThe branch codeBranch code The six-digit number identifying a South African bank branch, the equivalent of a sort code or a routing number elsewhere. Each bank publishes one universal branch code that works for every account it holds, which is the one to use unless you have been given another. of the account.
max length10
realTimePaymentboolean requiredWhether or not this payment should happen in real time. Please refer to the Ozow Pricing page for more information.
defaultfalse