创建换汇订单 - EasyPay API

填写 sell_currency 和 buy_currency。sell_amount 和 buy_amount 二选一，会根据汇率自动计算未填参数。

当 buy_currency 为 CNY 的时候需要填写 biz_type ,上传结汇明细 (*代表必输项,一次excel 最多上传 20000 条数据) 到 OSS，并将 OSS 地址填入 details_url：

如果只填写外币金额，未填写人民币金额，则外币金额的币种和总和必须与换汇订单中的卖出金额和币种一致。

如果同时填写外币金额和人民币金额，人民币金额总和需要与换汇订单中的买入金额一致，外币金额则不校验总额和币种。

请求参数

Header 参数

Authorization

string

可选

默认值:

Bearer {{access_token}}

Body 参数application/json

request_id

string

必需

商户订单 ID（商户唯一）

reference

string

可选

可用于保存额外订单信息

account_id

string

账户 ID

必需

sell_currency

string

卖出币种

必需

sell_amount

integer | null

可选

卖出金额（单位为分）

buy_currency

string

买入币种

必需

buy_amount

integer | null

可选

买入金额（单位为分）

biz_type

enum<string>

可选

业务性质，上传结汇明细必填

枚举值:

ECOMM

details_url

string

可选

结汇明细，买入币种为 CNY 的时候必填

value_date

string

可选

指定交割日（格式 yyyy-MM-dd）不传默认当天

settle_mode

enum<string>

可选

交割模式,不填默认是BALANCE

枚举值:

BALANCECREDIT

示例

{
  "request_id": "string",
  "reference": "string",
  "account_id": "string",
  "sell_currency": "string",
  "sell_amount": 0,
  "buy_currency": "string",
  "buy_amount": 0,
  "biz_type": "ECOMM",
  "details_url": "string",
  "value_date": "string",
  "settle_mode ": "BALANCE"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

data

object (Exchange)

必需

string

订单 ID

必需

request_id

string

必需

商户订单 ID（商户唯一）

reference

string | null

可选

商户可选填额外订单信息

order_no

string

订单号

必需

account_id

string

账户 ID

必需

sell_amount

integer

卖出金额

必需

sell_currency

string

卖出币种

必需

buy_amount

integer

买入金额

必需

buy_currency

string

买入币种

必需

exchange_rate

string

汇率

必需

reason

string | null

换汇失败原因

可选

status

enum<string>

状态

必需

枚举值:

PENDINGSUCCESSFAILED

details_status

enum<string> | enum<null>

结汇明细状态

可选

枚举值:

SUBMITTEDFAILED

details_url

string

结汇明细文件地址

可选

details_reason

array [anyOf]

可选

结汇明细失败原因，默认不展示，当 show_details_reason = true 时展示

value_date

string

预计交割日

必需

settle_mode

string

交割模式

必需

create_time

string

订单创建时间

必需

update_time

string

订单更新时间

必需

completed_time

string | null

订单完成时间

可选

示例

{
  "data": {
    "id": "string",
    "request_id": "string",
    "reference": "string",
    "order_no": "string",
    "account_id": "string",
    "sell_amount": 0,
    "sell_currency": "string",
    "buy_amount": 0,
    "buy_currency": "string",
    "exchange_rate": "string",
    "reason": "string",
    "status": "PENDING",
    "details_status": "SUBMITTED",
    "details_url": "string",
    "details_reason": [
      {
        "order_no": "string",
        "reason": "string"
      }
    ],
    "value_date": "string",
    "settle_mode": "string",
    "create_time": "string",
    "update_time": "string",
    "completed_time": "string"
  }
}