申请信用卡接口
申请下单
商户业务系统通过申请信用卡接口发起申请订单,BePay支付网关会根据商户配置的信用卡通道路由信用卡通道完成申请信用卡下单。网关根据不同的申请方式返回对应的申请状态。
接口说明
适用对象:普通商户
特约商户
请求URL:https://{BePay Domain}/api/applyCreditOrder
请求方式: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)
信用卡类型
creditType
是
int
1
通过【获取信用卡类型列表接口】而得到
申请信用卡手续费扣除的币种
applyFeeSymbol
是
String
USDT
扣除申请手续费的币种(当前仅支持USDT)
信用卡类型配置ID
configId
是
Long
1
通过【获取信用卡类型列表接口】而得到
申请用户的姓
firstName
否
String
xiao
申请用户的姓
申请用户的名字
lastName
是
String
ming
申请用户的名字
手机区号
phoneCode
否
String
86
手机区号
商户用户的手机号
mchUserPhone
否
String
123456789
商户用户的手机号
商户用户的地址
mchUserAddress
否
String
南京路
商户用户的地址
商户用户所在的城市
mchUserCity
否
String
南京
商户用户所在的城市
商户用户所在的区域
mchUserState
否
String
江苏
商户用户所在的区域(省/州/自治区)
商户用户所在的国家
mchUserCountry
否
String
中国
商户用户所在的国家
商户用户所在地的邮编
mchUserPostalCode
否
String
10001
商户用户所在地的邮编
信用卡的卡段
providerCardId
否
String
1234
信用卡的卡段(仅申请物理卡需要)
信用额度金额
quotaAmount
是
BigDecimal
100.00
信用额度金额
申请备注
applyDesc
是
String
网购
申请备注
是否后台审核
audit
是
Boolean
false
是否后台审核
异步回调地址
notifyUrl
是
String(3)
http://bepay.one
异步回调地址
特定提供商的额外can sh参数
channelExtra
否
String
{“auth_code”:“13920933111042”}
特定渠道发起的额外参数,json格式字符串.详见
扩展参数
extParam
否
String(512)
134586944573118714
商户扩展参数,回调时会原样返回
签名
sign
是
String(32)
C380BEC2BFD727A4B6845133519F3AD6
签名值,详见签名算法
请求示例数据
{
"mchNo": "M1623984572",
"appId": "60cc09bce4b0f1c0b83761c9",
"mchOrderNo": "mho1624005107281",
"mchUserId": "234562345",
"creditType": 1,
"applyFeeSymbol": "USDT",
"configId": 1,
"firstName": "xiao",
"lastName": "ming",
"phoneCode": "86",
"mchUserPhone": "123456789",
"mchUserEmail": "[email protected]",
"mchUserAddress": "南京路",
"mchUserCity": "南京",
"mchUserState": "江苏",
"mchUserCountry": "中国",
"mchUserPostalCode": "1001",
"quotaAmount": 100.00,
"applyDesc": "test",
"audit": false,
"notifyUrl": "https://www.bepay.one",
"channelExtra": "{\"authCode\":\"280812820366966512\"}",
"extParam": "",
"sign": "84F606FA25A6EC4783BECC08D4FDC681",
}
返回参数
返回信息
msg
否
String(128)
签名失败
具体错误原因,例如:签名失败、参数格式校验错误
签名信息
sign
否
String(32)
CCD9083A6DAD9A2DA9F668C3D4517A84
对data内数据签名,如data为空则不返回
返回数据
data
否
String(512)
{}
返回下单数据,json格式数据
data数据格式
申请订单号
applyId
是
String(30)
CA12021022311124442600
返回申请订单号
商户订单号
mchOrderNo
是
String(30)
20160427210604000490
返回商户传入的订单号
商户用户ID
mchUserId
是
String
234562345
商户用户ID
订单状态
state
是
int
2
支付订单状态 0-订单生成 1-申请中 2-申请成功 3-申请失败 4-已撤销 5-订单关闭
渠道订单号
channelOrderNo
是
String
d2395857382
渠道订单号
渠道错误码
errCode
否
String
ACQ.PAYMENT_AUTH_CODE_INVALID
上游渠道返回的错误码
渠道错误描述
errMsg
否
String
Business Failed 失败
上游渠道返回的错误描述
Last updated