Query Order Details

Applicable Scenarios

Used by B-side customers to actively query BBC order details after completing a C-side user recharge.

Supports querying order details by client-side order ID, transaction order ID, or ICCID.

Prerequisites

The request method must be GET.

The request path is /mall/order.

Notes

If multiple query parameters are provided simultaneously, the system will use only the first non-empty valid value according to the following priority order:

purchase_order_id (client-side order ID) > order_id (transaction order ID) > sim_id (ICCID)

When querying by sim_id (ICCID):

If the ICCID is associated with multiple orders, results are returned in descending order by order creation time.

Only orders created within the past year (365 days) are returned.

Business Rules

The caller must use a partnerCode belonging to their own enterprise, and may only query BBC orders under that enterprise.

The caller must provide at least one valid query condition — any one of the following:

sim_id (ICCID)

order_id (transaction order ID)

purchase_order_id (client-side order ID)

If querying by purchase_order_id and duplicate order numbers exist, only the most recent successfully paid order is returned.

This is a synchronous interface — the query result is returned immediately upon request.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

Bodyapplication/json

Example

{
    "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."
}

Applicable Scenarios#

Prerequisites#

Notes#