BePAY Development Docs
  • BePAY网关
  • 协议规则
  • 加密货币支付接口
    • 申请固定钱包地址
    • 申请DeFi钱包地址
    • 入金接口
    • 转账接口
    • 附件:加密货币示例
  • 法币支付接口
    • 支付下单接口
    • 转账接口
    • 分账接口
    • 获取支付方式详情
    • 附件:支付方式
    • 附件:入账方式
    • 附件:转账参数说明
    • 附件:银行数据
  • Page 3
    • Page 14
    • Page 13
  • Page 2
    • Page 18
    • Page 17
    • Page 16
    • Page 15
  • Page 1
    • Page 26
    • Page 25
    • Page 24
    • Page 23
    • Page 22
    • Page 21
    • Page 20
    • Page 19
  • Page
    • Page 29
    • Page 28
    • Page 27
  • Page 30
  • Page 32
  • Page 31
Powered by GitBook
On this page
  1. 加密货币支付接口

转账接口

特定商户业务系统通过转账接口发起请求,BeingFi支付网关会给对应链的钱包地址转。

接口说明

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

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

请求方式:POST

请求类型:application/json 或 application/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

目标地址

toAddress

是

String(50)

收取加密货币的钱包地址

转账金额

amount

是

BigDecimal

转账金额不能小于0.001

转账备注

transferDesc

是

String(50)

异步通知地址

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",
  "toAddress": "0xBC8c393959e5d8f2C96B1D5a8262a6762747B98b",
  "amount": 1.5,
  "transferDesc": "",
  "mchOrderNo": "M1651929947306188803"
}

返回参数

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

返回状态

code

是

int

0

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

返回信息

msg

否

String(128)

签名失败

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

签名信息

sign

否

String(32)

CCD9083A6DAD9A2DA9F668C3D4517A84

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

返回数据

data

否

String(512)

{}

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

data数据格式

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

转账单号

transferId

否

String(30)

U12021022311124442600

返回支付系统订单号

商户单号

mchOrderNo

否

String(30)

20160427210604000490

返回商户传入的订单号

渠道错误码

errCode

是

String

上游渠道返回的错误码

渠道错误描述

errMsg

否

String

Business Failed 失败

上游渠道返回的错误描述

返回示例数据

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

转账通知

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

接口说明

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

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

请求方式:POST

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

通知参数

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

转账订单号

transferId

是

String(30)

P12021022311124442600

返回转账系统订单号

商户号

mchNo

是

String(30)

M1621873433953

商户号

应用ID

appId

是

String(24)

60cc09bce4b0f1c0b83761c9

应用ID

商户订单号

mchOrderNo

是

String(30)

20160427210604000490

返回商户传入的订单号

商户用户id

mchUserId

是

String(30)

支付接口

ifCode

是

String(30)

wxpay

支付接口编码

支付金额

amount

是

BigDecimal

100

支付金额

收款账号

accountNo

是

String

收款人姓名

accountName

是

String

收款人开户行名称

bankName

是

String

转账备注信息

transferDesc

是

Sting

订单状态

state

是

int

2

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

特定渠道发起额外参数

channelExtra

是

String(256)

渠道订单号

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)

> 返回结果

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

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

通知示例数据

{
    
}
Previous入金接口Next附件:加密货币示例

Last updated 1 year ago