订单详情查询

适用场景

适用于 B 端客户在完成 C 端用户充值后，主动查询 BBC 订单详情的场景；

支持通过客户端订单ID、交易订单ID 或 ICCID 字段查询订单详情。

必要条件

请求方法必须为 GET；

请求路径为 /mall/order ；

注意事项

若同时传入多个查询参数，系统将按优先级顺序仅使用第一个非空有效值进行查询：

purchase_order_id（客户端订单ID） > order_id（交易订单ID） > sim_id（ICCID）

通过 sim_id（ICCID）查询时：

若该 ICCID 关联多个订单，按订单创建时间倒序返回；

仅返回最近一年内（365 天）的订单记录。

业务规则

调用方须使用归属本企业的 partnerCode ，仅可查询本企业名下的 BBC 订单；

调用方必须提供至少一个有效查询条件，三者任选其一：

sim_id（ICCID）

order_id（交易订单ID）

purchase_order_id（客户端订单ID）

若通过 purchase_order_id 查询且存在重复订单号，仅返回最近一次支付成功的订单；

接口为同步响应，调用后立即返回查询结果。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "data": {
        "sim_id": "89852202209089971478",
        "orders": [
            {
                "order_id": "CU-7ZOIHX0RB16U20250828111429591",
                "purchase_order_id": "4567",
                "bundle_name": "CLJF_ZRR_20250317_001",
                "cycles": "1",
                "total_amount": 1000,
                "payment_method": "stripe",
                "payee": "linksfield",
                "currency": "USD",
                "partner_name": "Excepteur deserunt eu labore",
                "paid_at": 1683178613876,
                "order_status": "active",
                "payment_status": "paid",
                "dispute_status": "none",
                "risk_status": "normal",
                "transaction_type": "one-time",
                "activated_at": 1683178613876
            }
        ]
    },
    "operateCode": "S",
    "message": "'order_id' and 'ICCID' was ignored because 'purchase_order_id' was provided."
}

🟢200success

适用场景#

必要条件#

注意事项#