创建订单
1. 接口调用:
2. 请求参数实例
参数 | 是否必须 | 说明 |
---|---|---|
depositCoinCode | 是 | eg:ETH |
receiveCoinCode | 是 | eg:BTC |
depositCoinAmt | 是 | eg:0.01 |
receiveCoinAmt | 是 | 期待接收数量 |
destinationAddr | 是 | "eg: 18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY 如有memo,请讲memo放到地址后,用#分隔,例如:18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY#1927632" |
refundAddr | 是 | "eg:18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY 如有memo,请讲memo放到地址后,用#分隔,例如:18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY#1927632" |
equipmentNo | 是 | 设备唯一编号 |
sourceType | 是 | ANDROID,IOS,H5 |
sourceFlag | 是 | 用于标识是哪个平台创建的订单,请联系我们沟通 |
isNoGas | 否 | 是否开启免 gas true/false |
slippage | 否 | 滑点 输入小数 0.01 = 10% |
3.请求参数示例
4.返回结果示例
5.返回参数说明
字段名称 | 字段 | 数据类型 | 备注 |
---|---|---|---|
订单号 | orderId | String | eg:d47e8b9b-c17f-432b-9285-a46c0a3ceb9a |
存币币种 | depositCoinCode | String | eg:ETH |
接收币币种 | receiveCoinCode | String | eg:BTC |
存币数量 | depositCoinAmt | String | eg:1 |
接收币数量 | receiveCoinAmt | String | eg:0.1 |
存币地址 | platformAddr | String | eg:123123123-232-1231232 |
目标币接收地址 | destinationAddr | String | "eg: 18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY, 如有memo,请讲memo放到地址后,用#分隔,例如:18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY#1927632" |
退原币的地址 | refundAddr | String | "eg: 18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY 如有memo,请讲memo放到地址后,用#分隔,例如:18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY#1927632" |
存币的手续费率 | depositCoinFeeRate | String | eg:手续费率 |
存币的手续费金额 | depositCoinFeeAmt | String | eg:手续费收取的原币的数量 |
退币金额 | refundCoinAmt | String | eg: 0.98 |
兑换成功交易id | transactionId | String | 链上交易id,在兑换完成并已发币之后,该字段才会有值 |
兑换失败交易id | refundDepositTxid | String | 链上交易id,在兑换失败退币情况下,已退币之后,该字段才会有值 |
订单状态 | detailState | String | "(1)wait_deposit_send:等待存币发送 (2)timeout:超时; (3)wait_exchange_push:等待交换信息推送; (4)wait_exchange_return:等待交换信息返回; (5.1)wait_receive_send:等待接收币种发送, wait_receive_confirm:等待接收币种确认, receive_complete:接收币种确认完成. (5.2)wait_refund_send:等待退原币币种发送, wait_refund_confirm:等待退原币币种确认, refund_complete:退原币币种确认完成; (6)ERROR/error:正在处理的订单 (7)WAIT_KYC: 等待进行KYC或联系客服提供链接" |
kyc的路径 | kycUrl | String | 当返回码是311时,需要跳转到该链接。 {host}/swft-v3/swft-v3-m/kyc/kyc.html?lang=cn&equipmentNo=pls_input_your_real_equipmentno_ok 请更新equipmentNo的值用户的设备号(公共请求参数),lang取值:cn、en |
开启免gas兑换返回的待签名数据 | noGasTxInfo | String | 需要对这个交易对象进行签名 |
兑换BTC时返回的Memo | btcMemo | String | 兑换BTC时返回的MEMO,详情请看(7.兑换BTC相关事项) |
6.Postman示例
7. 关于BTC兑换的注意事项
7.1. 默认api并不支持BTC兑换,请联系我们开通渠道白名单api才支持BTC兑换。支持后,创建订单接口将会新返回字段:btcMemo,该字段值为链上转账BTC时需要携带该值。客户端对接BTC兑换需要集成到钱包中,memo以OP_RETURN的形式携带上链(链上形式请见7.3)。如果未携带memo,直接将BTC转入我们的地址,将无法完成兑换。
7.2. memo举例说明:以0.1BTC->USDT(BSC)为例,返回的memo为: "btcMemo":"to:USDT(BSC):0x242Ea2A8C4a3377A738ed8a0d8cC0Fe8B4D6C36E" 拼接方式:to:币种:地址
7.3 BTC兑换后需手动上传存币hash,详情请见(上传hash接口)
上传交易hash批量上传交易hash7.4. 链上hash示例: https://mempool.space/tx/e8a7259a335e8488005b72dab98dd3087d52e0a94842d2d1a81262ebf8c3ef51
Last updated