2、创建代付

接口说明

商户调用该接口发起一笔代付订单，将指定加密资产从平台划转至目标用户地址，支持多链资产，如 USDT on ETH/TRON/BSC。

请求方式

POST

请求 URL

/api/v3/wallet/transfer

请求 Header

Content-Type: application/json;charset=utf-8

参数名	描述	示例值
access_key	商户后台获取	pFqV75X3
timestamp	Unix时间戳13位	1679724896223
nonce	UUID V4	794c26b0-d33c-4394-b2bb-c485eca16d9e
sign	HMAC-SHA1签名	kAXyh+eerqrefyaF8dyFB0M4FVo=

请求参数（JSON）

{
  "externalOrderId": "622257420681202921",
  "addressTo": "0x13666442fA7583F12369CC9F5449ec660295E8",
  "chainType": "ETH",
  "tokenType": "USDT",
  "currencyType": "USD",
  "cryptoAmount": "1",
  "notifyUrl": "http://192.168.1.135:30002/url",
  "remark": "http://192.168.1.135:30002/url"
}

参数说明

参数名	类型	描述	是否必填
externalOrderId	String(64)	商户订单 ID	是
addressTo	String(64)	收款地址（用户钱包地址）	是
chainType	String	加密主链类型，枚举值：ETH、TRON、BSC	是
tokenType	String	加密币种，枚举值： ETH: USDT,BUSD,TUSD,USDC,PUSD,ETH,TRX,TON,LINK,DAI,SHIB,UNI,LEO,OKB,PEPE TRON: USDT,TUSD,USDC,PUSD,TRX BSC: USDT,BUSD,TUSD,USDC,PUSD,BNB,XRP,ADA,DOGE,DOT,LTC,BCH,ETC,FIL,XTZ,CAT,PXP,GOUT,PEPE	是
cryptoAmount	String	加密金额，精度根据代币取(与cashierCurrencyAmount二选一)	否
currencyType	String	法币类型，枚举值：USD、BRL、CNY（若传入 currencyAmount 必传）	否
currencyAmount	String	法币金额，精度 ≤2 位（与cryptoAmount二选一；根据实时汇率计算 cryptoAmount）	否
notifyUrl	String	回调通知地址（如果有传，则回调该地址；如果没有，则回调商户后台配置的回调地址）	否
remark	String(1024)	订单备注	否

响应类型

Header:

Content-Type: application/json;charset=utf-8

响应数据示例

{
  "code": "200",
  "success": true,
  "msg": "成功",
  "msgEn": "SUCCESS",
  "data": {
    "orderId": "OCRYPDRAW202307310902401690794160841DOCKER020000000200001109",
    "orderStatus": "Accepted",
    "addressTo": "0xa8666442fA7583F783a169CC9F5449ec660295E8",
    "chainType": "ETH",
    "tokenType": "USDT",
    "tokenAmount": 1,
    "externalOrderId": "622257420681202921"
  }
}

响应参数说明

参数名	类型	描述
orderId	String	平台订单 ID
orderStatus	String	订单状态（如：Accepted）
addressTo	String	目标地址
chainType	String	主链类型
tokenType	String	加密代币类型
tokenAmount	Float64	实际支付代币金额
externalOrderId	String	商户订单号