换汇结果查询
- Endpoint:
POST /aggregate-pay/api/gateway/exchangeQuery - Tags: 外汇(老)
Description
商户可以通过换汇结果查询接口，查询历史的换汇交易结果。
Parameters
| Field | In | Type | Required | Constraints | Description |
|---|---|---|---|---|---|
Content-Type | header | string | Yes | ||
sign | header | string | Yes | 签名信息请参考技术文档 |
Parameter Examples
Content-Type:"application/json"sign:"FPFVT3o227JrFRbqu19boZCpVVTF9KznxyRawUmxpfXilHV/0yK46haPhAjNu1hPUMy7Vw/ILXhfzffNm4Fj0apWknlTY9OJxnSoQxS9BTFtc61tn5yV1q69x/kkBl82/qwg+XTJ4fOzy7Mar3VaC1E2PlDA6RkkKBUyNE6RYgsdB+Su7an4+4HVTNAnoe74WyvBgxTLMNg28igBTdqxaO3w/UBY6ObVp7vkqkQGdL1Y+HgmMYaAVwrM3+ALWGId0sJ+YqTY4WJ+0xCRGhaSnybiIjZsQEYyID68WNUfuavDLDsEhaMm/HfQvf5p0R1Ltovp3wwJnEbQcjY458iX5A=="
Request Body
Content-Type: application/json
| Field | Type | Required | Constraints | Description | Enum |
|---|---|---|---|---|---|
version | string | Yes | 接口版本 当前值为：1.1 | ||
keyVersion | string | Yes | maxLength: 8 | 密钥版本 当前值为：1 | |
requestTime | string | Yes | maxLength: 32 | 请求时间，符合rfc3339规范，格式：yyyy-MM-dd'T'HH:mm:ss.SSSXXX 时间需要在当前时间两分钟内 | |
appId | string | Yes | maxLength: 64 | 商户应用Id，PayerMax分配给商户应用的唯一标识 | |
merchantNo | string | No | maxLength: 32 | 商户号，商户与PayerMax业务签约时生成的唯一标识 | |
data | object | Yes | |||
data.outTradeNo | string | Yes | maxLength: 64 | 原商户订单号 |
Example
json
{
"version": "1.1",
"keyVersion": "1",
"requestTime": "2023-07-06T07:16:29.652+00:00",
"appId": "6666c8b036a24579974497c2f9a33333",
"merchantNo": "010213834784554",
"data": {
"outTradeNo": "20231101074142NU0870605007004088004"
}
}Responses
200
| Field | Type | Required | Constraints | Description | Enum |
|---|---|---|---|---|---|
code | string | Yes | 返回码，’APPLY_SUCCESS’代表成功 | ||
msg | string | Yes | 返回描述，’Success.’ | ||
data | object | Yes | |||
data.transactionCcy | string | Yes | 交易币种 | ||
data.side | string | Yes | 针对交易货币的买卖方向，买入BUY,卖出SELL | ||
data.tradeNo | string | Yes | PayerMax交易流水号 | ||
data.targetAmount | string | Yes | 到账金额 | ||
data.rateTime | string | Yes | 汇率生成时间 | ||
data.completeTime | string | Yes | 交易完成时间，符合rfc3339规范，格式：yyyy-MM-dd’T’HH:mm:ss.SSSXXX | ||
data.errorCode | string | Yes | 订单失败错误码 | ||
data.rateVersion | string | Yes | 汇率版本号 | ||
data.rate | string | Yes | 汇率 | ||
data.targetCcy | string | Yes | 目标币种 | ||
data.errorMsg | string | Yes | 订单失败错误码描述 | ||
data.ccyPair | string | Yes | 货币对 | ||
data.outTradeNo | string | Yes | PayerMax交易流水号 | ||
data.transactionAmount | string | Yes | 交易金额 | ||
data.status | string | Yes | 交易状态，SUCCESS成功, FAILED失败,PENDING进行中； 终态才进行回调 |
Response Example
json
{
"msg": "",
"code": "APPLY_SUCCESS",
"data": {
"transactionCcy": "IDR",
"side": "BUY",
"tradeNo": "20221128064248TU9975338200163533",
"targetAmount": "0.01",
"rateTime": "2022-11-28T06:42:48.000Z",
"completeTime": "2022-11-28T06:42:48.000Z",
"errorCode": "",
"rateVersion": "batch0003166961776821287950001",
"targetCcy": "USD",
"errorMsg": "",
"ccyPair": "USDIDR",
"rate": "15577.65000000",
"outTradeNo": "outTradeNo1669617768651",
"transactionAmount": "100.00",
"status": "SUCCESS"
}
}