Developers

# 订单查询

# 请求接口ROOT地址

  测试环境 : https://gateway-sandbox.luxpag.com
  正式环境 : https://gateway.luxpag.com

# 接口

  /trade/query

# Request Header

参数名 必须 描述
Content-Type 推荐 application/json
Authorization yes Basic Base64(app_id:secret_key)

# 请求参数（JSON格式）

参数名 类型 必须 最大长度/默认值 描述
app_id string yes 32 商户后台创建并获得
timestamp string yes 19 yyyy-MM-dd HH:mm:ss
out_trade_no string yes 64 商户订单号（和Luxpag订单号不能同时为空）
trade_no string yes 64 Luxpag订单号（和商户订单号不能同时为空）

# 请求样例

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}}"
}'

# 响应（JSON格式）

参数名 类型 描述
code string 返回码
msg string 返回消息
out_trade_no string 商户订单号
trade_no string Luxpag创建的订单号
trade_status string 订单状态
order_amount decimal 订单金额
order_currency string 订单币种

# 返回样例（成功）

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

# 返回样例（失败）

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

# 状态一览

目前能查询到的状态包括：

状态 描述
INITIAL 创建订单成功（初始状态）
PROCESSING 支付处理中（用户提交支付申请）
SUCCESS 支付成功（用户完成付款）
CANCEL 支付取消
RISK_CONTROLLING 风控处理中
DISPUTE 争议处理中
REFUSED 支付被拒
REFUND_VERIFYING 退款验证中（用户确认）
REFUND_PROCESSING 退款进行中
REFUNDED 退款
PARTIAL_REFUND 部分退款
CHARGEBACK 发生拒付

← 退款 →