查询支付订单列表

GET 
/openapi/2026-07/shoplazza-payment/payment-orders

分页返回支付订单列表，可按状态和创建时间范围过滤。

请求

Query参数

cursor string

分页游标

page_size int32

每页记录数（1-100，默认 10）

created_at_min string

筛选在该 Unix 时间及之后创建的支付订单（如 1730548810）

created_at_max string

筛选在该 Unix 时间及之前创建的支付订单（如 1730548810）

status string
按状态筛选支付订单：
• succeeded: 支付成功，资金已确认到账
• failed: 支付失败，资金未被处理
• requires_action: 需要额外操作才能完成支付（如 3D Secure 验证）
• init: 支付订单已创建但尚未处理
• canceled: 支付订单已取消，资金未被处理或已退回
• processing: 支付处理中，最终结果待确认

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

list object[]

支付订单记录列表

Array [

idstring

支付订单 ID

fee_details object

此支付订单的交易费用明细

trans_fee_amountstring

支付订单收取的交易费金额

fee_currencystring

交易费的币种代码（如 USD、EUR）

foreign_settlement_feestring

跨地区或跨币种结算时收取的境外结算费

created_atstring

支付订单的创建时间（如 2018-11-02T12:30:10Z）

finished_atstring

支付订单完成的时间（如 2018-11-02T12:30:10Z）

payment_statusstring

订单当前的支付状态：

• succeeded: 支付成功，资金已确认到账
• failed: 支付失败，资金未被处理
• requires_action: 需要额外操作才能完成支付（如 3D Secure 验证）
• init: 支付订单已创建但尚未处理
• canceled: 支付订单已取消，资金未被处理或已退回
• processing: 支付处理中，最终结果待确认

payment_methodstring

支付订单所使用的支付方式（如信用卡、PayPal）

card_brandstring

支付所使用信用卡的品牌（如 Visa、Mastercard）

pay_currencystring

消费者实际支付所使用的币种代码（如 USD、EUR）

pay_mountstring

消费者以 pay_currency 实际支付的金额

converted_amountstring

支付金额折算为店铺基础币种后的数值

reserve_amountstring

预留金额

order_idstring

与此次支付关联的订单标识符

fee_amountstring

此支付订单的服务费总额

]

cursorstring

分页游标

has_moreboolean

是否有更多记录

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "list": [
      {
        "id": "string",
        "fee_details": {
          "trans_fee_amount": "string",
          "fee_currency": "string",
          "foreign_settlement_fee": "string"
        },
        "created_at": "string",
        "finished_at": "string",
        "payment_status": "string",
        "payment_method": "string",
        "card_brand": "string",
        "pay_currency": "string",
        "pay_mount": "string",
        "converted_amount": "string",
        "reserve_amount": "string",
        "order_id": "string",
        "fee_amount": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}