Refund an Installment

The Amwal Installment API provides comprehensive refund functionality for installment transactions, supporting both partial and full refunds for online and in-store installment.

🔗 API Endpoint

POST /transactions/refund/{transaction_id}/

Refund a specific installment transaction by providing the transaction ID and refund amount.

Request Parameters

Parameter	Type	Required	Description
`transaction_id`	string (UUID)	✅	Unique transaction ID to refund from installment payment
`refund_amount`	number	✅	Refund amount (must be > 0 and ≤ original transaction amount)

Request Examples

{
  "refund_amount": 299.99
}

Success Response

{
  "status": "success",
  "key_type": "RefundReference", 
  "key": "2025001773"
}

Field	Description
`status`	Refund processing status
`key_type`	Type of reference key provided
`key`	Refund reference number for tracking

Error Responses (400)

The amount could be non refundable due to below error responses

{
  "detail": "This transaction is not refundable"
}

{
"detail": "Merchant account has insufficient balance for this refund"
}

Refund Use Cases

Product Returns

Process full or partial refunds for returned merchandise from installment purchases

Billing Corrections

Handle billing errors and overcharges on installment transactions

Order Modifications

Support partial refunds when customers modify their installment orders

Customer Satisfaction

Process goodwill refunds to maintain customer relationships

📌 Important Notes

Online Refunds: May take 3–5 business days depending on the payment method
Bank Installments: Processing time varies by issuing bank (typically 5-7 business days)
Minimum Requirements: Bank installment refunds require original transaction ≥ 1,000 SAR
Partial Refunds: Supported for order modifications and returns
Reference Tracking: Always store the refund reference key for customer service inquiries