Linksfield Developer
OverviewCube APIs旧版本API
OverviewCube APIs旧版本API
  1. Order
  • CSSS APIs
    • 全局说明/Overview
    • 国际化/ Internationalization
    • 状态码/Status code
    • 签名代码示例 / Sign code Example
    • SIM
      • 批量获取拥有的设备信息/Get all SIM cards info
      • 查询单一设备实时信息/Get real-time info about one SIM card
      • 同步使用中SIM卡信息/Get the SIM Cards in use
    • Usage
      • 查询单张SIM卡流量使用情况/ Example Query the traffic usage of a single SIM card
      • 批量查询SIM卡流量接口 /Batch querying SIM card usage
      • 查询单日流量使用情况 / Example Query the daily usage
      • 批量查询指定月份的流量使用情况/ Batch querying the usage in a specified month
    • Plan
      • 同步资费套餐 / Get data plan
      • 订购流量套餐/ Order data plan
      • 批量订购套餐/ Bulk order package
      • 续订流量套餐/ Renew your data plan
      • 查询套餐订单信息 / Query the package order information
      • 开通/启用流量套餐订单 / To enable the order
      • 取消流量套餐订单/ Cancel an unenabled package order
      • 提前结束设备套餐订单/ End package orders early
      • [不推荐]停机/暂停流量套餐订单
      • [不推荐]复机/重新启动流量套餐订单
      • 【不推荐】分页批量(查询)同步设备可订购套餐
    • SMS
      • 发送短信/ send SMS
    • Customized
      • OTA日套餐下单/Order OTA Plan
      • 运营商侧剩余流量查询/Query the remaing data by MNO side
  • Notification
    • Notification全局说明
    • Notification状态码
    • 流量使用量API预警
      POST
    • 短信下行回调
      POST
    • 短信上行回调
      POST
    • 短信上行回调(区分文本二进制)
      POST
    • 订单状态变更回调(IMSI)
      POST
  • Mall APIs
    • Mall全局说明
    • Mall业务流程
    • Mall签名代码示例
    • APP调用Stripe的SDK示例说明
    • Vshop
      • 卡片登录验证
      • 获取可购套餐商品列表
      • 创建用户订单
      • 查询正在使用、未启用订单
      • 获取生效中的自动续费
      • 关闭自动续费
      • 用户下单(第三方支付)
    • Payment
      • 获取stripe单次支付权限
      • 获取Stripe订阅支付权限
      • 创建Stripe订阅/自动续费
      • 支付结果查询
    • Notification
      • 充值成功消息推送
    • Bundle-groups
      • 添加SIM卡至指定分组
      • 从指定分组删除SIM卡
      • 查询所有分组及套餐基本信息
      • 查询指定分组的 SIM 卡号
      • 异步结果获取
    • Order
      • 订单详情查询
        GET
  • eSIM QR Mall APIs
    • Introduction
    • Pre - order
    • webhook
    • 用户登录
    • My eSIM Detail
OverviewCube APIs旧版本API
OverviewCube APIs旧版本API
  1. Order

订单详情查询

Cube UAT
Cube UAT
GET
/mall/order

适用场景#

适用于 B 端客户在完成 C 端用户充值后,主动查询 BBC 订单详情 的场景;
支持通过 客户端订单ID、交易订单ID 或 ICCID 字段查询订单详情。

必要条件#

1.
请求方法必须为 GET;
2.
请求路径为 /mall/order ;

注意事项#

1.
若同时传入多个查询参数,系统将按 优先级顺序 仅使用第一个非空有效值进行查询:
purchase_order_id(客户端订单ID) > order_id(交易订单ID) > sim_id(ICCID)
2.
通过 sim_id(ICCID) 查询时:
若该 ICCID 关联多个订单,按订单创建时间倒序返回;
仅返回最近一年内(365 天)的订单记录。

业务规则#

1.
调用方须使用归属本企业的 partnerCode ,仅可查询本企业名下的 BBC 订单;
2.
调用方必须提供 至少一个有效查询条件,三者任选其一:
sim_id(ICCID)
order_id(交易订单ID)
purchase_order_id(客户端订单ID)
3.
若通过 purchase_order_id 查询且存在重复订单号,仅返回最近一次支付成功的订单;
4.
接口为 同步响应,调用后立即返回查询结果。

请求参数

Query 参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET '/mall/order?sim_id&order_id&purchase_order_id&version&partnerCode&sign' \
--header 'Content-Type: application/json'

返回响应

🟢200成功
application/json
Body

示例
{
    "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
修改于 2026-01-31 05:09:30
上一页
异步结果获取
下一页
Introduction
Built with