二维码充值

根据法币及其汇率生成需要支付的数字货币的二维码

  • 请求路径

URL
request
version
Content-Type

/v1/recharge/qrCodeFiat

POST

1.0

application/json

  • 请求参数

请求参数
类型
必填
参数说明
示例

clientId

String

true

业务方用户id

66c94478ce0d205aeb501b91

chainCode

String

true

网络(链)

tron、eth、bnb等

tokenCode

String

false

网络币种

trx、usdt等

amount

decimal

true

虚拟币金额

10

refOrderId

String

true

业务方订单id,需唯一

SN20241111033312

appId

String

true

appId

06870bb9e276b6aac7dd8d4f34e10b98

timestamp

Long

true

时间戳(毫秒)-以 UTC 为基准

1726804102287

sign

String

true

请求签名

JOqrp8E1ydxeLBF9KABt

fiat

String

true

法币币种

详见底部

rate

decimal

false

接入方传入汇率(传入法币和当前虚拟币 对应的汇率,比如:充值VDN支付 USDT,就传入USDT 对 VND 的汇率 25411.10)

25411.10

callbackUrl

String

false

回调地址,充值成功后则回调当前地址,若不传入则调用商户配置回调地址

fiatAmount

decimal

false

法币金额(选填,不传或金额为0,虚拟币充值)

10000

  • 返回参数

返回参数
参数类型
参数说明

code

String

失败才会有错误码

msg

String

错误信息

success

Boolean

是否成功(true:成功,false:失败)

data

返回数据

data.url

String

支付连接

data.hash

String

交易hash

data.status

Integer

充值状态 1.充值中 2. 充值完成 3.订单超时(10分钟未检测到充值,则超时)

  • 请求签名样例顺序(rsa 生成签名原始内容

法币充值:

amount=10000&appId=0129b01d6de2c1e643c05eb298366d97&callbackUrl=https://xxx.xxx.com/callback/recharge&chainCode=tron&clientId=677511eb4520af1f81dda00a11&fiat=CNY&fiatAmount=10000&rate=0&refOrderId=SN202501011500351231&timestamp=1735737911755&tokenCode=usdt

数字货币: amount=10&appId=cd88bd0f01fdd4c71233a04728527bc7&callbackUrl=http://www.google.com&chainCode=tron&clientId=floadAdmin&refOrderId=CZ202506181243&timestamp=1750230504952&tokenCode=usdt

  • 请求参数

法币充值:
{
  "amount": 1000,
  "appId": "0129b01d6de2c1e643c05eb298366d97",
  "callbackUrl": "https://xxx.xxx.com/callback/recharge",
  "chainCode": "tron",
  "clientId": "677511eb4520af1f81dda00a",
  "fiat": "CNY",
  "rate": 7.3,
  "fiatAmount": 7300,
  "refOrderId": "SN20250101150035123",
  "sign": "5ThyTy9DmF3EFKspKw20pBrHUbm4Fwy/X6jhyjINPJnkED/iBxqllN7YA+V6DY4LN2yo7DLVRjcrSQlVlJHOPA==",
  "timestamp": 1735736705186,
  "tokenCode": "usdt"
}

数字货币充值:
{
	"amount": 10,
	"appId": "cd88bd0f01fdd4c71233a04728527bc7",
	"callbackUrl": "http://www.google.com",
	"chainCode": "tron",
	"clientId": "floadAdmin",
	"refOrderId": "CZ202506181243",
	"timestamp": 1750230504952,
	"tokenCode": "usdt"
}

  • 返回

{
  "data": {
    "url": "https://xxx.xxx.com?data=rtsWht3F7rTHdM6kVrd7IepwiCgGXaCJDfw0a5yoyqng39ZL0xZwkhdVltx17l6VZz3sC4OyiiOK/1Z6EfMun+lSZ7kOCUjlz/Zx7O1IplBVRn+ywqz0AMZGuiPYWHN2zBDogRIqelj+HkA/qqnW4s2vxpw20VerZpBd9pqzUfI5JekDOhG85//P+aLQutHY/2sWlhE8I0C0766GELaZHgx0/Kf2iFDtct8CrzOk14oAx/Rd6VY/cyWTnu9qzmDRLs3Rlz/88XBwiNUvVOdIeS3XZXswW28Yd+2ysx5cFu4=",
    "hash": null,
    "status": 1
  },
  "success": true
}

  • 支持的法币

USD, AUD, BRL, CAD, CHF, CLP, CNY, CZK, DKK, EUR, GBP, HKD, HUF, IDR, ILS, INR, JPY, KRW, MXN, MYR, NOK, NZD, PHP, PKR, PLN, RUB, SEK, SGD, THB, TRY, TWD, ZAR, AED, BGN, HRK, MUR, RON, ISK, NGN, COP, ARS, PEN, VND, UAH, BOB, ALL, AMD, AZN, BAM, BDT, BHD, BMD, BYN, CRC, CUP, DOP, DZD, EGP, GEL, GHS, GTQ, HNL, IQD, IRR, JMD, JOD, KES, KGS, KHR, KWD, KZT, LBP, LKR, MAD, MDL, MKD, MMK, MNT, NAD, NIO, NPR, OMR, PAB, QAR, RSD, SAR, SSP, TND, TTD, UGX, UYU, UZS, VES

Last updated