Refund
Refund Service
Request URL
- Sandbox
- Production
POST https://sandbox-th.lianlianpay-inc.com/gateway
POST https://api.lianlianpay.co.th/gateway
Request Body
| Parameter | Type | Length | Required | Description |
|---|---|---|---|---|
| version | string | 4 | true | fixed value: v1 |
| service | string | 64 | true | fixed values: llpth.refund.apply |
| merchant_id | string | 18 | true | unique identifier for merchant assigned by LianLian, 8 digits prefix with '14' |
| merchant_refund_id | string | 64 | true | unique for each refund flow |
| merchant_order_id | string | 64 | true | merchant order id, only digits, characters and underline are supported, unique value for each transaction |
| refund_amount | string | 8,2 | true | refund amount, up to two decimal |
| refund_currency | string | 3 | true | refund currency, supported Currency |
| refund_reason | string | 256 | false | refund reason |
| notify_url | string | 256 | false | refund result webhook |
Response Body
| Parameter | Type | Length | Required | Description |
|---|---|---|---|---|
| merchant_id | string | 18 | true | merchant id |
| refund_order_id | string | 18 | true | lianlian refund order id |
| merchant_refund_id | string | 64 | true | merchant refund id |
| refund_amount | string | 8,2 | true | refund amount, up to two decimal |
| refund_currency | string | 3 | true | refund currency, supported Currency |
| refund_status | string | 2 | true | refund status, see Refund Status |
| create_time | string | 19 | true | refund create time, timezone with UTC+7(Asia/Bangkok) |
Request Sample
{
"version": "v1",
"service": "llpth.refund.apply",
"merchant_id": "142023010100009001",
"merchant_order_id": "ORDER_202301010001",
"merchant_refund_id": "REFUND_202301010001",
"refund_amount": "88.99",
"refund_currency": "THB",
"refund_reason": "order cancel",
"notify_url": "https://www.lianlianpay.co.th/sample/callback"
}
Response Sample
{
"code": 200000,
"data": {
"merchant_id": "142023010100009001",
"refund_order_id": "122023010100160021",
"merchant_refund_id": "REFUND_202301010001",
"refund_status": "RP",
"refund_amount": "88.99",
"refund_currency": "THB",
"create_time": "2023-01-01 13:19:02"
},
"message": "Success",
"trace_id": "54e2983e66b738e6"
}
Curl Sample
curl -X POST \
-H 'Content-Type: application/json' \
-H 'sign-type: RSA' \
-H 'sign: ACXIbRDxK1ETQ51s4LEq1MkLQptK5nEnEG1eUykzz5oH+StkOYqZnNP9uaiNoaqJqdWP0CD3b0dHQWJGCiUx+3EpYE5FSujakMFnh0wL8GrdtJ7nA4+cDd4xSQHq5wBX5GnbEYnD7bXV3hEC9A0sBqx7Z87deXiuE+L0j35hTut/QFRvHOBMDvMfgO1OiPkNWmJ6jf20LrE3D4RJJru8o70aUM++lLOPPdbeghDXIYM/veHu+w3wU3nDY5kbsD/9IeaOE40qO/Tykyk2LeBbhpV1QNW/gqr0C7CEmt0IcYLKHkCvVieroGzmXZNyPxVglD0M2nxSeXFQ0SGcclqWTg==' \
-i https://sandbox-th.lianlianpay-inc.com/gateway \
-d '{"version":"v1","service":"llpth.refund.apply","merchant_id":"142023010100009001","merchant_order_id":"ORDER_202301010001","merchant_refund_id":"REFUND_202301010001","refund_amount":"88.99","refund_currency":"THB","refund_reason":"order cancel","notify_url":"https://www.lianlianpay.co.th/sample/callback"}'
Refund Policy
💡Important
In terms of partial refund limit described below regarding Credit/Debit card, TrueMoney, ShopeePay and Line Pay, in such case, LianLian suggest you request partial refund:
- if paid before 8:00 PM, refund after 6:00 AM the next day.
- if paid after 8:00 PM, refund after 6:00 AM two days after transaction.
| Payment | Partial Refund | Refund | Note |
|---|---|---|---|
| Alipay (Online) | |||
| Alipay (In-Store) | |||
| WeChat Pay | |||
| QR PromptPay | |||
| Credit/Debit Card | 1. Partial Refund is not supported before bank settled. For UnionPay card refund, please contact our customer service. 2. Full refund, no refund time limit. 3. Refund process depend on the policy of each bank, the money will be refunded within 45 working days. | ||
| Installment | Refund via API or Portal is supported only before bank settled. If you want to refund after bank settled, please contact our customer service. | ||
| Mobile Banking | |||
| TrueMoney | 1. Partial Refund, for both card and balance payment, is not supported before TrueMoney settled. 2. Full refund, no refund time limit. | ||
| ShopeePay | 1. Partial Refund, for both card and balance payment, is not supported before ShopeePay settled. 2. Full refund, no refund time limit. | ||
| Line Pay | 1. Partial Refund, for card payment, is not supported before Line Pay settled. 2. Partial Refund, for balance payment, no refund time limit. 3. Full refund, no refund time limit. | ||
| Counter Pay | |||
| Direct debit |