跳到主要内容

换汇申请

请求地址

[POST] /v1/mid-open-api/exchange/create
需要验证签名

接口描述

通过查询到的汇率信息发起换汇申请

提示

平台接收到换汇请求,会校验汇率是否在有效期,如果校验失败,会通知换汇失败。

请求头

ParameterTypeRequiredDescription
AuthorizationstringMaccess_token
Content-TypestringMapplication/json

请求参数

Request:

ParameterTypeRequiredDescription
partner_order_idstring(64)M客户订单号 ,需要保证唯一
client_idstring(64)M客户ID
sell_currencystring(3)M卖出币种
buy_currencystring(3)M买入币种
sell_amountdecimal(18,2)M卖出金额,最多两位小数
buy_amountdecimal(18,2)M买入金额=卖出金额*汇率,四舍五入保留两位小数
rate_idlongM汇率ID
ratedecimal(18,9)M汇率
extra_infostring(128)O扩展字段

返回响应

ParameterTypeRequiredDescription
partner_order_idstring(64)M客户订单号
order_idstring(64)M平台订单号
statusstring(64)M状态,见下方说明

返回示例

{
"code": 200,
"message": "SUCCESS",
"data": {
"status": "PROCESSING",
"partner_order_id": "test_6ac4adc3d17d",
"order_id": "OE2309060002435297"
}
}

错误码

错误码描述解决方案
900000system error系统错误,请联系PingPong技术人员核查
900002illegal param参数有误,请根据提示更正信息
950000query account error账户查询错误,请稍后重试或联系PingPong技术人员核查

status状态值

状态值描述
PROCESSING处理中
SUCCESS成功
FAILED失败