API 文档

# 1、创建收款

接口说明

商户调用该接口创建新的加密货币收款订单，系统返回收银台链接及订单明细，用户可通过收银台完成支付。

请求方式

POST

请求 URL

/api/v3/wallet/pay

请求 Header

Content-Type: application/json;charset=utf-8
参数名 描述 示例值
access_key 商户后台获取 pFqV75X3
timestamp Unix 时间戳13位（毫秒） 1679724896223
nonce UUID V4 794c26b0-d33c-4394-b2bb-c485eca16d9e
sign 计算出的签名 kAXyh+eerqrefyaF8dyFB0M4FVo=

请求参数（JSON）

{
  "externalOrderId": "402297358314559082",
  "cashierChainType": "ETH",
  "cashierTokenType": "USDT",
  "cashierCryptoAmount": "1",
  "cashierCurrencyType": "USD",
  "hiddenMerchantLogo": 0,
  "hiddenMerchantName": 0,
  "notifyUrl": "http://192.168.1.135:30002/url",
  "remark": "123"
}

参数说明

参数名 类型 描述 是否必填
externalOrderId String(64) 商户订单 ID 是
cashierChainType String 收银台主链类型，枚举值：ETH、TRON、BSC 否
cashierTokenType 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 否
cashierCryptoAmount String 加密金额，精度根据代币取(与cashierCurrencyAmount二选一) 否
cashierCurrencyAmount String 法币金额，精度≤2位(与cashierCryptoAmount二选一；会按照平台汇率自动换算对应加密金额) 否
cashierCurrencyType String 法币类型，枚举值：USD、BRL、CNY（若传法币金额，则必传） 否
hiddenMerchantLogo int64 是否隐藏商户 Logo，枚举值：0、1 0-不隐藏Logo 1-隐藏Logo （不传默认为0） 否
hiddenMerchantName int64 是否隐藏商户名称，枚举值：0、1 0-不隐藏名称 1-隐藏名称 （不传默认为0） 否
notifyUrl String 回调地址（如果有传，则回调该地址；如果没有，则回调商户后台配置的回调地址） 否
remark String(1024) 订单备注 否
successRedirectUrl String 支付成功后跳转地址 否

响应类型

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

响应示例****1（根据加密类型提单）

{
  "code": "200",
  "success": true,
  "msg": "成功",
  "msgEn": "SUCCESS",
  "data": {
    "cashierId": "OCRYPPAID202307310902391690794159250DOCKER020000000200001107",
    "cashierUrl": "http://192.168.1.74:89/OCRYPPAID202307310902391690794159250DOCKER020000000200001107",
    "cashierExpireTime": 1690794759313,
    "cashierCryptoAmount": "1",
    "cashierCurrencyAmount": "0.98",
    "cashierRate": 0.983,
    "cashierCurrencyType": "USD",
    "cashierTokenType": "USDT",
    "cashierChainType": "ETH",
    "isHiddenMerchantName": false,
    "isHiddenMerchantLogo": false,
    "externalOrderId": "402297358314559082",
    "remark": "123",
    "cryptoOrder": {
      "addressTo": "0xe072c63c1e04f8c6f36133f6629f66778147d5d8",
      "orderId": "OCRYPPAID202307310902391690794159441DOCKER020000000400001108",
      "externalOrderId": "402297358314559082",
      "exchangeRate": 0.983,
      "currencyAmount": "0.98",
      "cryptoAmount": "1",
      "currencyType": "USD",
      "tokenType": "USDT",
      "chainType": "ETH",
      "orderStatus": "Wait pay",
      "orderStatusCode": 1,
      "orderExpireTime": 1690801360527
    }
  }
}

响应示例2（根据法币类型提单）

{
  "code":"200",
  "success":true,
  "msg":"成功",
  "msgEn":"SUCCESS",
  "data":{
    "cashierId":"OCRYPPAID20250417031656174485981616300000201297223",
    "cashierUrl":"http://192.168.1.74:89/OCRYPPAID2025041703165617448598161630000201297223",
    "cashierExpireTime":1744860416178,
    "cashierCurrencyAmount":10,
    "cashierRate":0,
    "cashierCurrencyType":"BRL",
    "cashierTokenType":"",
    "cashierChainType":"",
    "isHiddenMerchantName":true,
    "isHiddenMerchantLogo":true,
    "externalOrderId":"00637444",
    "remark":"test order",
    "cryptoOrder":{
    }
  }
}

响应参数说明

参数名 类型 描述
cashierId String 收银台 ID
cashierUrl String 收银台链接
cashierExpireTime int64 收银台有效期时间戳
cashierCryptoAmount string 收银台加密金额
cashierCurrencyAmount string 收银台法币金额
cashierRate float64 收银台当前汇率
cashierCurrencyType String 收银台法币类型
cashierTokenType String 收银台加密币类型
cashierChainType String 收银台加密主链类型
isHiddenMerchantName Boolean 是否隐藏商户名
isHiddenMerchantLogo Boolean 是否隐藏商户 Logo
externalOrderId String 商户订单号
remark String 备注
addressTo String 区块链收款地址
orderId String 订单 ID
exchangeRate float64 生成订单时汇率
currencyAmount String 订单法币金额
cryptoAmount String 订单加密币金额
currencyType String 订单法币类型
tokenType String 订单加密币种
chainType String 订单主链类型
orderExpireTime int64 订单过期时间戳
orderStatus String 订单状态描述
orderStatusCode int64 状态码，枚举值：1、2、4、8、16 正常创建收款订单的响应为1，后续其他状态可以通过查询/回调更新。详细说明请参考下方订单状态码说明

订单状态码说明

状态码 状态描述 是否终态 说明
1 待支付 否 订单已创建，用户尚未付款；无需处理
2 链上确认中 否 用户在收银台点击“已完成支付”，系统正在检测链上是否到账；无需处理
4 已完成 是 支付成功，系统会触发回调；商户需根据业务逻辑增加余额或完成发货等操作
8 支付金额不匹配 是 用户支付金额 ≠ 应付金额，系统会触发回调；建议按实际支付金额入账
16 超时收款 是 用户支付超时，系统不会再回调；商户如确认收款到账需手动处理
32 未支付（地址释放） 是 用户长时间未支付，地址释放；若后续支付将生成新订单

← 2、创建代付 →