创建换汇订单

POST

/v1/exchanges

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

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

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

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

请求参数

Header 参数

Body 参数application/json

示例

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

curl --location --request POST 'https://demo-api.easypayx.com/v1/exchanges' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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"
}'

返回响应

🟢200成功

application/json

Body

示例

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

修改于 2025-04-07 11:07:09

查询汇率

查询换汇订单列表