Submit Trade Orders

Submit a batch of trade orders to build up quota for CNY cross-border payouts. B2B orders can be associated with incoming payments or your Chinese vendor-related trade materials, and multiple B2C orders can be uploaded directly. Each trade order is validated independently.
Request Parameters
When sceneCode = B2B_FUNDS_ASSOCIATION
batchRequestIdstring
required
Idempotency key for this batch. Assign a unique value (e.g., UUID) per request to safely retry without creating duplicate submissions.
sceneCodestring
required
Business scenario code that determines the downstream processing path.

Valid Values:

B2B_FUNDS_ASSOCIATION — B2B funds association. Associate B2B receiving payments with trade orders to accumulate trade-order quota. Available to B2B merchants registered with CN/HK entity.
subSceneCodestring
Sub-scenario code for B2B business.

Valid Values:

9710 — Cross-border e-commerce exports to overseas business buyers (B2B) under customs supervision code 9710.
9810 — Cross-border e-commerce export to overseas warehouse.
9610 — Cross-border e-commerce exports to overseas individual consumers (B2C) under customs supervision code 9610.
0110 — General trade export.
1039 — Market procurement trade.
quotaAccumulationMethodstring
required
Method used to accumulate settlement quota. Supported values: DEPOSIT_ID.
quotaAccumulationIdstring
required
Accumulation identifier paired with quotaAccumulationMethod.

Valid Values:

DEPOSIT_ID — Unique Deposit/Collection identifier of a B2B deposit received in your WorldFirst account.
tradeOrdersarray
required
List of trade order details. Maximum 100 elements; at least 1 required.
Show child parametersShow child parameters
additionalInfoobject
Reserved extension field. Up to 10 key-value pairs.
Response Parameters
resultResult
See Result.
idstring
System-generated batch identifier. Use this ID to query processing status.
batchRequestIdstring
Echo of the idempotency key provided in the request.
statusstring
Batch status. During the synchronous submit phase, always ACCEPTED. See BatchStatus.
tradeOrdersarray
Per-order processing results. Returned when the call succeeds.
Show child parametersShow child parameters
createdAtdatetime
Timestamp when the batch was created. ISO 8601 extended format (for example, 2026-04-29T10:05:00+08:00).
Error Codes
resultCoderesultStatusresultMessageTroubleshooting
SUCCESSSsuccessN/A
Definition
POST /api/open/v1/tradeOrders/submit
Request
{
"batchRequestId": "req_20260429002",
"sceneCode": "B2B_FUNDS_ASSOCIATION",
"quotaAccumulationMethod": "DEPOSIT_ID",
"quotaAccumulationId": "2208****",
"tradeOrders": [
  {
    "referenceOrderNo": "ORD_20260429002",
    "paidAt": "2026-04-29T09:30:00+08:00",
    "transAmount": {
      "currency": "USD",
      "value": 50000
    },
    "tradeAmount": {
      "currency": "USD",
      "value": 48000
    },
    "tradeCategory": "GOODS",
    "orderDirection": "CREDIT",
    "usedForExchange": true,
    "logisticsMode": "REGULAR_MODE",
    "goods": [
      {
        "referenceGoodsId": "GOODS_****",
        "goodsName": "Industrial Equipment",
        "goodsCnName": "工业设备",
        "goodsUnit": "SET",
        "goodsQuantity": 2,
        "storeUrl": "https://store.example.com/goods/2",
        "goodsUnitAmount": {
          "currency": "USD",
          "value": 24000
        },
        "goodsCategory": "ELECTRONICS"
      }
    ],
    "bizContractInfo": {
      "buyerEnName": "Global Trading Co., Ltd.",
      "tradeRegion": "US",
      "deliverRegion": "US",
      "contracts": [
        {
          "fileName": "contract_2026.pdf",
          "fileKey": "oss://bucket/path/contract_2026.pdf"
        }
      ]
    },
    "shipping": {
      "shipped": true,
      "declared": false,
      "newBuyer": true,
      "tradeTerms": "FOB",
      "expectedShippingDate": "2026-05-10",
      "wayBillInfos": [
        {
          "logisticsCompany": {
            "providerKey": "DHL",
            "providerValue": "DHL Express"
          },
          "shippingMethod": "OCEAN",
          "shippingOrderReferenceNo": "DHL1234567890",
          "shippingAddress": {
            "region": "US",
            "city": "Los Angeles"
          }
        }
      ]
    }
  }
]
}
Response
{
"result": {
  "resultCode": "SUCCESS",
  "resultMessage": "success",
  "resultStatus": "S"
},
"id": "unique_****",
"batchRequestId": "req_20260429001",
"status": "ACCEPTED",
"createdAt": "2026-04-29T10:05:00+08:00",
"tradeOrders": [
  {
    "referenceOrderNo": "ORD_20260429001",
    "orderStatus": "ACCEPTED",
    "statusMessage": "Accepted, pending process.",
    "tradeAmount": {
      "currency": "USD",
      "value": 9500
    },
    "transAmount": {
      "currency": "USD",
      "value": 10000
    },
    "orderDirection": "CREDIT"
  }
]
}