1. Refund Transaction
Conditions:
- The user must be a KYC-verified member in the Payment Support Portal to submit a refund request.
- The admin will process and return the requested amount to user within 24 hours of the request
- In the case of BCEL transactions, the request fee is non-refundable. However, no fee will be charged for JDB or IB transactions
2. Overview
In these refund workflows, a customer initiates a refund request after a purchase, which sets off a series of steps across different entities. The process involves the customer, the merchant platform, the payment support system, and the bank or payment support admin, depending on the flow.
2.1. Bcel Bank refund workflow
- Customer : requests a refund via the Platform Owner, initiating the process for a transaction reversal.
- Merchant : sends the refund request to the Payment Support System for further processing.
- Payment Support System : forwards the request to the Bank, asking for the refund to be issued.
- Bank : processes and returns the refund directly to the Customer’s account, completing the transaction
2.2. JDB and IB Bank refund workflow
- Customer :requests a refund through the Merchant Platform, initiating the refund process.
- Merchant :forwards the refund request to the Payment Support System for further action.
- Phapay admin : reviews and approves the refund after verification.
- Phapay admin: manually returns the refund to the Customer, completing the process
3. Refund Transaction via Payment Support API
To request the refund transaction via Payment Support API by using transaction ID:
3.1. Request refund transaction
URL: https://payment-gateway.lailalolab.com/v1/api/refund (opens in a new tab)
Method: POST
Headers: secretKey: <your_secret_key>
Body:
| Field | Type | Description |
|---|---|---|
| transactionId | String | A unique identifier for the transaction,repeated for convenience |
| Response Data: |
{
"message": "SUCCESSFULLY",
"data":{
"id": "66fd2e6be097f64ebbdf23ba",
"status": "REQUESTING",
"amount": 1000,
"createdAt": "2024-10-02T11:28:43.625Z",
"billNo": "LPG710301"
}
}3.2. Check refund transaction status
URL: https://payment-gateway.lailalolab.com/v1/api/refund/{bill_id} (opens in a new tab)
Method: GET
Headers: secretKey: <your_secret_key>
Note:
| Field | Type | Description |
|---|---|---|
| bill_id | String | A unique identifier for the refund transaction bill, you can get it after request refund transaction with the field (id) |
| Field | Type | Description |
|---|---|---|
| message | String | A string indicating the status of the API call. For successful calls |
| id | String | A bill id that is a unique identifier for the refund transaction bill, using for 1.2.2. Check refund status |
| status | String | The current status of the refund transaction bill |
| amount | String | The amount of the refund bill (the transaction amount) |
| billNo | String | A bill no of the refund transaction bill |
| createdAt | DateTime | The timestamp indicating when the transaction was created |
{
"message": "SUCCESSFULLY",
"data":
{
"id": "66fd2e6be097f64ebbdf23ba",
"status": "REQUESTING",
"amount": 1000,
"createdAt": "2024-10-02T11:28:43.625Z",
"billNo": "LPG710301"
}
}4. Refund Transaction via Payment Support Portal
- Go to Payment Portal https://portal.lailaolab.la/ (opens in a new tab) when you get a contact from the customer for refunding.
- You would see list of transactions and choose a transaction for approval.
- Then click confirm to request approval from admin.
- After clicking confirm, it will navigate to review management while waiting for approval from the admin.
After approval by admin, you will see that the refund request has been approved.
For complete details on integrating and using the Refund API.
Click here to access:
Refund API Documentation (PDF)