入金接口

商户商户统一下单

商户业务系统通过入金接口发起请求,BeingFi支付网关会临时分配对应链的钱包地址用于入金。

接口说明

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

请求URL:https://{BeingFi Pay Domain}/api/crypto/unifiedOrder

请求方式:POST

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

请求参数

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

商户号

mchNo

String(30)

M1621873433953

商户号

应用ID

appId

String(24)

60cc09bce4b0f1c0b83761c9

应用ID

商户订单号

mchOrderNo

String(30)

商户生成的订单号

商户用户ID

mchUserId

String(30)

test001

链代码

chain

String(30)

ETH

代币符号

symbol

String(30)

USDT

订单失效时间

expiredTime

int

300

订单超时时间,60秒到600秒之间

异步通知地址

notifyUrl

String(128)

扩展参数

extParam

String(512)

商户扩展参数,回调时会原样返回

请求时间

reqTime

long

1622016572190

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

接口版本

version

String(3)

1.0

接口版本号,固定:1.0

签名

sign

String(32)

C380BEC2BFD727A4B6845133519F3AD6

签名值,详见签名算法

签名类型

signType

String(32)

MD5

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

请求示例数据

{
  "extParam": "",
  "chain": "ETH",
  "symbol": "USDT",
  "sign": "84F606FA25A6EC4783BECC08D4FDC681",
  "reqTime": "1624005107",
  "version": "1.0",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "signType": "MD5",
  "mchNo": "M1623984572",
  "mchUserId": "test001",
  "mchOrderNo": "M1651929947306188803",
  "expiredTime": 300
}

返回参数

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

返回状态

code

int

0

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

返回信息

msg

String(128)

签名失败

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

签名信息

sign

String(32)

CCD9083A6DAD9A2DA9F668C3D4517A84

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

返回数据

data

String(512)

{}

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

data数据格式

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

支付订单号

payOrderId

String(30)

U12021022311124442600

返回支付系统订单号

商户订单号

mchOrderNo

String(30)

20160427210604000490

返回商户传入的订单号

钱包地址

address

String(64)

返回示例数据

{
  "code": 0,
  "data": {
    "errCode": "0",
    "payOrderId": "P1651929947306188802",
    "mchOrderNo": "M1651929947306188803",
    "address": "0xb625083b1BfbC5Cbe85Daa9ea1162981654f0647"
  },
  "msg": "SUCCESS",
  "sign": "F4DA202C516D1F33A12F1E547C5004FD"
}

支付通知

当订单支付成功时,支付网关会向商户系统发起回调通知。如果商户系统没有正确返回,支付网关会延迟再次通知。

接口说明

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

请求URL:该链接是通过统一下单接口提交的参数notifyUrl设置,如果无法访问链接,商户系统将无法接收到支付中心的通知。

请求方式:POST

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

通知参数

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

支付订单号

payOrderId

String(30)

P12021022311124442600

返回支付系统订单号

商户号

mchNo

String(30)

M1621873433953

商户号

应用ID

appId

String(24)

60cc09bce4b0f1c0b83761c9

应用ID

商户订单号

mchOrderNo

String(30)

20160427210604000490

返回商户传入的订单号

商户用户id

mchUserId

String(30)

链代码

chain

String(30)

ETH

tokenId

String(30)

合约地址

contractAddress

String(30)

fromAddress

String(30)

订单状态

state

int

2

支付订单状态 0-订单生成 1-支付中 2-支付成功 3-支付失败 4-已撤销 5-已退款 6-订单关闭

客户端IP

clientIp

String(32)

210.73.10.148

客户端IPV4地址

商品标题

subject

String(64)

Jeepay商品标题测试

商品标题

商品描述

body

String(256)

Jeepay商品描述测试

商品描述

渠道订单号

channelOrderNo

String

20160427210604000490

对应渠道的订单号

渠道错误码

errCode

String

1002

渠道下单返回错误码

渠道错误描述

errMsg

String

134586944573118714

渠道下单返回错误描述

扩展参数

extParam

String(512)

134586944573118714

商户扩展参数

创建时间

createdAt

long

1622016572190

订单创建时间,13位时间戳

成功时间

successTime

long

1622016572190

订单支付成功时间,13位时间戳

通知请求时间

reqTime

String(30)

1622016572190

通知请求时间,,13位时间戳

签名

sign

String(32)

C380BEC2BFD727A4B6845133519F3AD6

签名值,详见签名算法

代币符号

symbol

String(32)

USDT

> 返回结果

业务系统处理后同步返回给支付中心,返回字符串 success 则表示成功,返回非success则表示处理失败,支付中心会再次通知业务系统。(通知频率为0/30/60/90/120/150,单位:秒)

注意:返回的字符串必须是小写,且前后不能有空格和换行符。

通知示例数据

{
   
}

Last updated