信用卡入金接口

加密货币入金

商户业务系统通过加密货币入金接口发起信用卡入金。BePay网关根据不同的加密货币类型向对应的信用卡账户进行入金操作，将对应商户的用户账户中的加密货币余额充值到提供的信用卡账户中。

接口说明

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

请求URL：https://{BePay Domain}/api/credit/crypto/depositOrder

请求方式：POST

请求类型：application/json 或 application/x-www-form-urlencoded

请求参数

字段名	变量名	必填	类型	示例值	描述
商户号	mchNo	是	String(30)	M1621873433953	商户号
应用ID	appId	是	String(24)	60cc09bce4b0f1c0b83761c9	应用ID
商户订单号	mchOrderNo	是	String(30)	20160427210604000490	商户生成的订单号
商户用户ID	mchUserId	是	String	234562345	商户处的用户ID(唯一ID)
支付方式	wayCode	是	String(30)	PIX	支付方式,如巴西支付 PIX,详细见【附件：支付方式】分页
订单金额	amount	是	BigDecimal	100.00	订单金额（固定保留2位小数）
货币代码	currency	是	String(3)	cny	三位货币代码,人民币:cny，详细见：【附件：货币代码】分页
客户端IP	clientIp	否	String(32)	210.73.10.148	客户端IPV4地址
商品标题	subject	是	String(64)	商品标题测试	商品标题
商品描述	body	是	String(256)	商品描述测试	商品描述
异步通知地址	notifyUrl	否	String(256)	https://www.jeequan.com/notify.htm	支付结果异步回调URL,只有传了该值才会发起回调
跳转通知地址	returnUrl	否	String(256)	https://www.jeequan.com/return.htm	支付结果同步跳转通知URL
失效时间	expiredTime	否	int	3600	订单失效时间,单位秒,默认2小时.订单在(创建时间+失效时间)后失效
额外参数	channelExtra	否	String(256	{“auth_code”:“13920933111042”}	特定渠道发起的额外参数,json格式字符串.详见附件：支付额外参数
分账模式	divisionMode	否	int	0	分账模式： 0-该笔订单不允许分账[默认], 1-支付成功按配置自动完成分账, 2-商户手动分账(解冻商户金额)
扩展参数	extParam	否	String(512)	134586944573118714	商户扩展参数,回调时会原样返回
请求时间	reqTime	是	long	1622016572190	请求接口时间,13位时间戳
接口版本	version	是	String(3)	1.0	接口版本号，固定：1.0
签名	sign	是	String(32)	C380BEC2BFD727A4B6845133519F3AD6	签名值，详见签名算法
签名类型	signType	是	String(32)	MD5	签名类型，目前只支持MD5方式

请求示例数据

{
  "amount": 100.00,
  "extParam": "",
  "mchOrderNo": "mho1624005107281",
  "mchUserId": "234562345",
  "subject": "商品标题",
  "wayCode": "ALI_BAR",
  "sign": "84F606FA25A6EC4783BECC08D4FDC681",
  "reqTime": "1624005107",
  "body": "商品描述",
  "version": "1.0",
  "channelExtra": "{\"authCode\":\"280812820366966512\"}",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "clientIp": "192.166.1.132",
  "notifyUrl": "https://www.jeequan.com",
  "signType": "MD5",
  "currency": "cny",
  "returnUrl": "",
  "mchNo": "M1623984572",
  "divisionMode": 1
}

返回参数

字段名	变量名	必填	类型	示例值	描述
返回状态	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	返回商户传入的订单号
订单状态	orderState	是	int	2	支付订单状态 0-订单生成 1-支付中 2-支付成功 3-支付失败 4-已撤销 5-已退款 6-订单关闭
支付数据类型	payDataType	是	String	payUrl	详见下方：payDataType说明
支付数据	payData	否	String	http://www.jeequan.com/pay.html	发起支付用到的支付参数，如果微信公众号支付等
渠道错误码	errCode	否	String	ACQ.PAYMENT_AUTH_CODE_INVALID	上游渠道返回的错误码
渠道错误描述	errMsg	否	String	Business Failed 失败	上游渠道返回的错误描述

data数据数据中payDataType详细说明

法币入金

商户业务系统通过法币入金接口发起信用卡入金。BePay网关根据不同国家的法定货币类型向对应的信用卡账户进行入金操作。将对应商户的用户账户中的法币余额充值到提供的信用卡账户中。（该接口暂时无法使用）

接口说明

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

请求URL：https://{BePay Domain}/api/credit/fiat/depositOrder

请求方式：POST

请求类型：application/json 或 application/x-www-form-urlencoded

请求参数

字段名	变量名	必填	类型	示例值	描述
商户号	mchNo	是	String(30)	M1621873433953	商户号
应用ID	appId	是	String(24)	60cc09bce4b0f1c0b83761c9	应用ID
商户订单号	mchOrderNo	是	String(30)	20160427210604000490	商户生成的订单号
商户用户ID	mchUserId	是	String	234562345	商户处的用户ID(唯一ID)
支付方式	wayCode	是	String(30)	PIX	支付方式,如巴西支付 PIX,详细见【附件：支付方式】分页
订单金额	amount	是	BigDecimal	100.00	订单金额（固定保留2位小数）
货币代码	currency	是	String(3)	cny	三位货币代码,人民币:cny，详细见：【附件：货币代码】分页
客户端IP	clientIp	否	String(32)	210.73.10.148	客户端IPV4地址
商品标题	subject	是	String(64)	商品标题测试	商品标题
商品描述	body	是	String(256)	商品描述测试	商品描述
异步通知地址	notifyUrl	否	String(256)	https://www.jeequan.com/notify.htm	支付结果异步回调URL,只有传了该值才会发起回调
跳转通知地址	returnUrl	否	String(256)	https://www.jeequan.com/return.htm	支付结果同步跳转通知URL
失效时间	expiredTime	否	int	3600	订单失效时间,单位秒,默认2小时.订单在(创建时间+失效时间)后失效
额外参数	channelExtra	否	String(256	{“auth_code”:“13920933111042”}	特定渠道发起的额外参数,json格式字符串.详见附件：支付额外参数
分账模式	divisionMode	否	int	0	分账模式： 0-该笔订单不允许分账[默认], 1-支付成功按配置自动完成分账, 2-商户手动分账(解冻商户金额)
扩展参数	extParam	否	String(512)	134586944573118714	商户扩展参数,回调时会原样返回
请求时间	reqTime	是	long	1622016572190	请求接口时间,13位时间戳
接口版本	version	是	String(3)	1.0	接口版本号，固定：1.0
签名	sign	是	String(32)	C380BEC2BFD727A4B6845133519F3AD6	签名值，详见签名算法
签名类型	signType	是	String(32)	MD5	签名类型，目前只支持MD5方式

请求示例数据

{
  "amount": 100.00,
  "extParam": "",
  "mchOrderNo": "mho1624005107281",
  "mchUserId": "234562345",
  "subject": "商品标题",
  "wayCode": "ALI_BAR",
  "sign": "84F606FA25A6EC4783BECC08D4FDC681",
  "reqTime": "1624005107",
  "body": "商品描述",
  "version": "1.0",
  "channelExtra": "{\"authCode\":\"280812820366966512\"}",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "clientIp": "192.166.1.132",
  "notifyUrl": "https://www.jeequan.com",
  "signType": "MD5",
  "currency": "cny",
  "returnUrl": "",
  "mchNo": "M1623984572",
  "divisionMode": 1
}

返回参数

字段名	变量名	必填	类型	示例值	描述
返回状态	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	返回商户传入的订单号
订单状态	orderState	是	int	2	支付订单状态 0-订单生成 1-支付中 2-支付成功 3-支付失败 4-已撤销 5-已退款 6-订单关闭
支付数据类型	payDataType	是	String	payUrl	详见下方：payDataType说明
支付数据	payData	否	String	http://www.jeequan.com/pay.html	发起支付用到的支付参数，如果微信公众号支付等
渠道错误码	errCode	否	String	ACQ.PAYMENT_AUTH_CODE_INVALID	上游渠道返回的错误码
渠道错误描述	errMsg	否	String	Business Failed 失败	上游渠道返回的错误描述

data数据数据中payDataType详细说明