Query

Payment Query

Request URL

Sandbox

GET https://sandbox-th.lianlianpay-inc.com/gateway

Production

GET https://api.lianlianpay.co.th/gateway

Request Parameters

Parameter	Type	Length	Required	Description
version	string	4	true	fixed value: v1
service	string	64	true	fixed values: llpth.payment.query
merchant_id	string	18	true	unique identifier for merchant assigned by LianLian, 8 digits prefix with '14'
merchant_order_id	string	64	true	merchant order id

Response Body

Parameter	Type	Length	Required	Description
merchant_id	string	18	true	merchant_id in request
merchant_order_id	string	64	true	merchant_order_id in request
order_id	string	18	true	lianlian bill id, one on one with merchant order id
order_status	string	2	true	see status enums Payment Status
order_amount	string	8,2	true	order_amount in request
order_currency	string	3	true	order_currency in request
order_desc	string	256	true	order description
product_code	string	64	false	payment product, see Payment Product first level
payment_method	string	64	false	payment method, see Payment Product second level
customer	Customer	-	false	payer user info
products	List	-	false	payer product info, see Product
create_time	string	19	true	payment bill create time, timezone with UTC+7(Asia/Bangkok)
complete_time	string	19	false	payment bill complete time, timezone with UTC+7(Asia/Bangkok)

---

Request Sample

https://sandbox-th.lianlianpay-inc.com/gateway?version=v1&service=llpth.payment.query&merchant_id=142023010100009001&merchant_order_id=ORDER_202301010001

Response Sample

{
    "code": 200000,
    "data": {
        "merchant_id": "142023010100009001",
        "merchant_order_id": "ORDER_202301010001",
        "order_id": "122023010100160021",
        "order_status": "PS",
        "order_amount": "88.99",
        "order_currency": "THB",
        "order_desc": "display your order info",
        "product_code": "BANKCARD_PAY_ONLINE",
        "payment_method": "CARD",
        "customer": {
            "merchant_user_id": "USER_0001",
            "full_name": "Bruce Lee"
         },
        "create_time": "2023-01-01 13:19:02",
        "complete_time": "2023-01-01 13:19:13"
    },
    "message": "Success",
    "trace_id": "582090476275e0aa"
}

Curl Sample

curl -X GET \
  -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?version=v1&service=llpth.payment.query&merchant_id=142023010100009001&merchant_order_id=ORDER_202301010001

Refund Query

Request URL

Sandbox

GET https://sandbox-th.lianlianpay-inc.com/gateway

Production

GET https://api.lianlianpay.co.th/gateway

Request Parameters

Parameter	Type	Length	Required	Description
version	string	4	true	fixed value: v1
service	string	64	true	fixed values: llpth.refund.query
merchant_id	string	18	true	unique identifier for merchant assigned by LianLian, 8 digits prefix with '14'
merchant_refund_id	string	64	true	merchant refund id

Response Body

Parameter	Type	Length	Required	Description
merchant_id	string	18	true	merchant_id in request
merchant_refund_id	string	64	true	merchant refund id
merchant_order_id	string	64	true	merchant_order_id in request
order_id	string	18	true	lianlian bill id, one on one with merchant order id
refund_order_id	string	18	true	lianlian refund order 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
refund_reason	string	256	false	refund reason
notify_url	string	256	false	refund result webhook
create_time	string	19	true	refund create time, timezone with UTC+7(Asia/Bangkok)
complete_time	string	19	false	refund complete time, timezone with UTC+7(Asia/Bangkok)

Request Sample

https://sandbox-th.lianlianpay-inc.com/gateway?version=v1&service=llpth.refund.query&merchant_id=142023010100009001&merchant_refund_id=REFUND_202301010001

Response Sample

{
    "code": 200000,
    "data": {
        "merchant_id": "142023010100009001",
        "merchant_refund_id": "REFUND_202301010001",
        "merchant_order_id": "ORDER_202301010001",
        "order_id": "122023010100160021",
        "refund_order_id": "122023010100160022",
        "refund_status": "RS",
        "refund_amount": "88.99",
        "refund_currency": "THB",
        "refund_reason": "order cancel",
        "notify_url": "https://www.lianlianpay.co.th/sample/callback",
        "create_time": "2023-01-01 13:19:02",
        "complete_time": "2023-01-01 13:19:13"
    },
    "message": "Success",
    "trace_id": "582090476275e0aa"
}

Curl Sample

curl -X GET \
  -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?version=v1&service=llpth.refund.query&merchant_id=142023010100009001&merchant_refund_id=REFUND_202301010001