贸易材料申请

POST/v1/global-payout/transaction-document/apply

请求参数

mch_id

string

商户编号

必需

商户编号是商户在平台上开设的商户号码，为18位数字

<= 18 字符

sub_mch_id

string

子商户号

可选

子商户号（平台商模式下必传），为18位数字

txn_seqno

string

必需

商户贸易材料申报请求流水号，应保证申报请求全局唯一

<= 64 字符

trade_document_id

string

必需

商户侧唯一的贸易材料ID

<= 64 字符

payer_id

string

必需

付款人id，商户在全球付款系统中申报成功的付款人id

<= 64 字符

beneficiary_id

string

必需

收款人id，商户在全球付款系统中申报成功的收款人id

<= 64 字符

business_type

enum<string>

业务场景

必需

<= 32 字符

枚举值:

ECOMMERCE

counterparty_name

string

必需

交易对手方姓名，收款人名称

<= 64 字符

counterparty_country_code

string

必需

交易对手所处国家/地区编码，两位编码，参考：https://en.wikipedia.org/wiki/ISO_3166-2

<= 2 字符

trade_name

string

必需

交易名称，无格式要求，多个交易，逗号分隔；

<= 128 字符

trade_count

integer

必需

交易数量，填写交易商品数量

trade_amount

string

必需

大于0的数字，精确到小数点后两位。示例：49.10，最大值：99999999.99

<= 12 字符

trade_currency

string

必需

交易币种，三位标准格式，参考：https://www.iban.hk/currency-codes
目前仅支持CNY币种

示例值:

CNY

trade_time

string

交易时间

必需

示例值:

20251013171901

正则匹配:

yyyyMMddHHmmss

contract_no

string

合同编号/账单编号

必需

<= 64 字符

trade_detail

object

必需

logistic_info

object

物流信息

必需

mip_order_info

object

必需

聚数订单信息，校验聚数收单时必填

notify_url

string

可选

贸易材料申报结果通知地址，如上送则会往这个接口发生申报结果通知

<= 256 字符

{
  "mch_id": "string",
  "sub_mch_id": "string",
  "txn_seqno": "string",
  "trade_document_id": "string",
  "payer_id": "string",
  "beneficiary_id": "string",
  "business_type": "ECOMMERCE",
  "counterparty_name": "string",
  "counterparty_country_code": "st",
  "trade_name": "string",
  "trade_count": 0,
  "trade_amount": "string",
  "trade_currency": "CNY",
  "trade_time": "20251013171901",
  "contract_no": "string",
  "trade_detail": {
    "logistic_info": {
      "logistics_company": "string",
      "logistics_order_no": "string"
    },
    "mip_order_info": {
      "platform_txno": "string",
      "mch_txno": "string"
    }
  },
  "notify_url": "string"
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

ret_code

string

必需

返回码，0000-受理成功

ret_msg

string

返回码描述

必需

mch_id

string

商户编号

可选

商户在平台上开设的商户号码，为18位数字，如：201304121000001004

txn_seqno

string

可选

返回码=0000，返回商户贸易材料申报请求流水号

platform_txno

string

可选

返回码=0000，返回平台订单号，连连订单唯一编号

txn_status

enum<string>

申请状态

可选

返回码=0000，返回申请状态

枚举值:

PROCESSINGFAIL

fail_reason

string

失败原因

可选

申请状态=FAIL，返回失败原因

{
  "ret_code": "string",
  "ret_msg": "string",
  "mch_id": "string",
  "txn_seqno": "string",
  "platform_txno": "string",
  "txn_status": "PROCESSING",
  "fail_reason": "string"
}