换汇申请
- Endpoint:
POST /aggregate-pay/api/gateway/exchange - Tags: 外汇(老)
Description
换汇功能用于将商户不同币种之间的可用余额进行换汇(当前仅支持其中一个币种为USD)。
Parameters
| Field | Type | Required | Description |
|---|
Content-Type (header) | string | Yes | |
sign (header) | string | Yes | 签名信息请参考技术文档 |
Request Body
| Field | Type | Required | Description |
|---|
version | string | Yes | 接口版本 当前值为:1.1 |
keyVersion | string | Yes | 密钥版本 当前值为:1 |
requestTime | string | Yes | 请求时间,符合rfc3339规范,格式:yyyy-MM-dd'T'HH:mm:ss.SSSXXX 时间需要在当前时间两分钟内 |
appId | string | Yes | 商户应用Id,PayerMax分配给商户应用的唯一标识 |
merchantNo | string | No | 商户号,商户与PayerMax业务签约时生成的唯一标识 |
data | object | Yes | |
data.ccyPair | string | Yes | 货币对 |
data.outTradeNo | string | Yes | 商户订单号 |
data.side | string | Yes | 针对交易货币的买卖方向,买入BUY,卖出SELL |
data.transactionAmount | string | Yes | 交易货币金额 |
data.transactionCcy | string | Yes | 交易货币 |
data.targetCcy | string | Yes | 目标币种 |
data.rateVersion | string | No | 汇率版本,如果不输入则表示使用最近一次版本进行交易 |
Responses
200
| Field | Type | Required | Description |
|---|
code | string | Yes | 返回码,’APPLY_SUCCESS’代表成功 |
msg | string | Yes | 返回描述,’Success.’ |
data | 返回数据体 | Yes | |
data.transactionCcy | string | Yes | |
data.side | string | Yes | |
data.tradeNo | string | Yes | |
data.targetAmount | string | Yes | |
data.rateTime | string | Yes | 符合rfc3339规范,格式:yyyy-MM-dd’T’HH:mm:ss.SSSXXX |
data.completeTime | string | Yes | 符合rfc3339规范,格式:yyyy-MM-dd'T'HH:mm:ss.SSSXXX |
data.errorCode | string | Yes | |
data.rateVersion | string | Yes | |
data.targetCcy | string | Yes | |
data.errorMsg | string | Yes | |
data.ccyPair | string | Yes | |
data.rate | string | Yes | |
data.outTradeNo | string | Yes | |
data.transactionAmount | string | Yes | |
data.status | string | Yes | |