信用卡状态更新接口

统一下单

商户业务系统通过信用卡状态更新接口发起信用卡状态的更新，BePay网关会根据商户发起的更新类型，来对信用卡的状态进行更新，更新状态包含：注销，冻结，解冻等。

接口说明

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

请求URL：https://{BePay Domain}/api/creditUpdate

请求方式：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详细说明