PaymentTokenID申请

• Endpoint: POST /aggregate-pay/api/gateway/applyPaymentToken
• Tags: 收单/Tokenization支付

Parameters

Field	Type	Required	Description
sign (header)	string	Yes
Content-Type (header)	string	Yes

Request Body

Field	Type	Required	Description	Enum
data	object	Yes	请求数据体
data.requestId	string	Yes	请求单号，唯一标识商户的一笔请求
data.country	string	Yes	国家代码，大写字母
data.paymentMethodType	string	Yes	支付方式类型，支持CARD、BANKTRANSFER
data.targetOrg	['string', 'null']	No	目标机构，当paymentMethodType=BANKTRANSFER，值传YUSHANBANK
data.userId	string	Yes	商户内部的用户Id，需要保证每个ID唯一性
data.frontCallbackUrl	string	Yes	商户指定的跳转URL，完成token绑定后会被跳转到该地址，以http/https开头或者商户应用的scheme地址。
data.tokenScope	string	Yes	固定值：tokenAcq
data.mitType	['string', 'null']	No	mit类型，token申请完成后用于mit代扣的类型；为空时，生成的token只能用于CIT；不为空时，值为SCHEDULE、UNSCHEDULE，生成的token可用于CIT和MIT代扣	SCHEDULE, UNSCHEDULE
data.cardInfo	['object', 'null']	No	卡信息，当paymentMethodType=CARD时，必需
data.envInfo	['object', 'null']	No
data.riskParams	object	No	详见风控业务数据【商户上送信息】
version	string	Yes	接口版本 当前值为：1.4
keyVersion	string	Yes	密钥版本 当前值为：1
requestTime	string	Yes	请求时间，符合rfc3339规范，格式：yyyy-MM-dd'T'HH:mm:ss.SSSXXX 时间需要在当前时间两分钟内
appId	string	Yes	商户应用Id，PayerMax分配给商户应用的唯一标识
merchantNo	string	No	商户号，商户与PayerMax业务签约时生成的唯一标识

Responses

200

Field	Type	Required	Description	Enum
data	object	Yes
data.redirectUrl	string	No	token认证地址，当status=PENDING时有值
data.requestId	string	Yes	请求单号
data.status	string	Yes	状态	PENDING, SUCCESS, FAILED
data.paymentTokenID	string	No	token值，当status=SUCCESS时有值
code	string	Yes	返回码，’APPLY_SUCCESS’代表成功
msg	string	Yes	返回描述，’Success.’

Enum Reference

data.mitType

• SCHEDULE
• UNSCHEDULE