申请信用卡接口

申请下单

商户业务系统通过申请信用卡接口发起申请订单,BePay支付网关会根据商户配置的信用卡通道路由信用卡通道完成申请信用卡下单。网关根据不同的申请方式返回对应的申请状态。

接口说明

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

请求URL:https://{BePay Domain}/api/applyCreditOrder

请求方式:POST

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

商户用户的手机号

商户用户的邮箱

mchUserEmail

String

商户用户的邮箱

商户用户的地址

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",
}

返回参数

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

返回状态

code

int

0

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

返回信息

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