申请信用卡接口

申请下单

商户业务系统通过申请信用卡接口发起申请订单，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	商户用户的手机号
商户用户的邮箱	mchUserEmail	否	String	[e-mail]	商户用户的邮箱
商户用户的地址	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": "[e-mail]",
  "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 失败	上游渠道返回的错误描述