价格查询

购买的加密货币数量是根据进入的法定货币数量计算的,返回的数量可能与实际收到的数量不同。

接口说明

适用对象:普通商户 特约商户

请求URL:https://{BePay Domain}/api/crypto/buy/priceQuery

请求方式:POST

请求类型:application/jsonapplication/x-www-form-urlencoded

请求参数

字段名
变量名
必填
类型
示例值
描述

加密货币购买配置ID

cryptoBuyConfigId

Long

1

购买加密货币配置接口获取

虚拟币币种

cryptoCurrency

String

USDT

币种,例如USDT,请参考加密货币查询接口

链代码

chain

String

TRX

加密货币网络,如TRX,请参考加密货币查询接口

法币货币代码

fiatCurrency

String

USD

法币类型,字符编码符合ISO4217编码(如USD, EUR, JPY, GBP),参考法币查询接口

法币金额

amount

BigDecimal

100.00

法币购买金额

商户号

mchNo

String

M1621873433953

商户号

应用ID

appId

String

60cc09bce4b0f1c0b83761c9

应用ID

请求时间

reqTime

long

1622016572190

请求接口时间,13位时间戳

接口版本

version

String

1.0

接口版本号,固定:1.0

签名类型

signType

String

MD5

签名类型,目前只支持MD5方式

签名

sign

String

C380BEC2BFD727A4B6845133519F3AD6

签名值,详见签名算法

请求示例数据

{
  "cryptoBuyConfigId": 1,
  "fiatCurrency": "USD",
  "cryptoCurrency": "USDT",
  "chain": "TRX",
  "amount": 100.00,
  "appId": "60cc09bce4b0f1c0b83761c9",
  "mchNo": "M1623984572",
  "version": "1.0",
  "signType": "MD5",
  "reqTime": "1624005107",
  "sign": "84F606FA25A6EC4783BECC08D4FDC681",
}

返回参数

字段名
变量名
必填
类型
示例值
描述

返回状态

code

int

0

0-处理成功,其他-处理有误,详见错误码

返回信息

msg

String(128)

签名失败

具体错误原因,例如:签名失败、参数格式校验错误

签名信息

sign

String(32)

CCD9083A6DAD9A2DA9F668C3D4517A84

对data内数据签名,如data为空则不返回

返回数据

data

String(512)

{}

返回下单数据,json格式数据

返回示例数据

{
    "code": 0,
    "data": {
        "cryptoPrice": "1.005", // crypto's current price
        "rampFee": "4.39", // estimated rampFee
        "cryptoQuantity": "94.13", // // estimated crypto amount can buy
        "networkFee": "1.00", // estimated networkFee
        "fiat": "USD", // fiat
        "rawRampFee": "4.39", 
        "crypto": "USDT" // crypto
    },
    "msg": "SUCCESS"
}

Last updated