Developers

# Trade Query

# Request Base URL

  Test Environment : https://gateway-sandbox.luxpag.com
  Prod Environment : https://gateway.luxpag.com

# EndPoints

  /trade/query

# Request Header

Parameter Required Description
Content-Type recommend application/json
Authorization yes Basic Base64(app_id:secret_key)

# Request Body (JSON format)

Parameter Type Required Max Length(or Default Value) Description
app_id string yes 32 created app's id at dashboard
timestamp string yes 19 yyyy-MM-dd HH:mm:ss
out_trade_no string yes 64 Merchant's trade NO.(cannot be empty with trade_no at same time)
trade_no string yes 64 Luxpag trade NO.(cannot be empty with out_trade_no at same time)

# Request Sample

curl --location --request POST 'https://gateway.luxpag.com/trade/query' \
--header 'Authorization: Basic Base64(appid:secret_key)' \
--header 'Content-Type: application/json' \
--data-raw '{
    "app_id": "app_id",
    "timestamp": "{{datetime}}",
    "out_trade_no": "{{out_trade_no}}",
    "trade_no": "{{trade_no}}"
}'

# Http Response (JSON format)

Parameter Type Description
code string return code
msg string return msg
out_trade_no string merchant's trade NO.
trade_no string Luxpag's trade NO.
trade_status string status
order_amount decimal amount
order_currency string currency

# Return Code (Success)

{
    "code": "10000",
    "msg": "Success",
    "out_trade_no": "{{out_trade_no}}",
    "trade_no": "{{trade_no}}",
    "trade_status": "{{status}}",
    "order_amount": {{amount}},
    "order_currency": "{{currency}}"
}

# Return Code (Fail)

{
    "code": "40002",
    "msg": "Business Failed",
    "sub_code": "invalid-signature",
    "sub_msg": "invalid signature"
}

# Status List

Status Description
INITIAL once merchant create order success
PROCESSING after user submit the payment info
SUCCESS trade succeeded
CANCEL cancelled
RISK_CONTROLLING in risk control (caused by high risk or unclear billing information)
DISPUTE dispute
REFUSED refused
REFUND_VERIFYING refund virifying (confirmed by user)
REFUND_PROCESSING refund processing (processing by administrator)
REFUNDED refunded
PARTIAL_REFUND partially refunded
CHARGEBACK chargeback

← Refund →