Apply Drop-in Session

• Endpoint: POST /aggregate-pay/api/gateway/applyDropinSession(for-auth-capture-copy-me)
• Tags: 收单/Auth-Capture

Description

在商户服务端调用该接口，获取用于初始化前置组件的主要参数

Parameters

Field	Type	Required	Description
Content-Type (header)	string	Yes
sign (header)	string	Yes	签名信息请参考技术文档

Request Body

Field	Type	Required	Description	Enum
version	string	Yes	接口版本 当前值为：1.6
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业务签约时生成的唯一标识
data	请求数据体	Yes
data.totalAmount	string	No	非必填，如果需要传值，则只有传了mitType时，totalAmount才支持传0；其他情况需要大于0
data.mitType	string	No	签约代扣产品后，可传mitType	SCHEDULED, UNSCHDULED
data.captureMode	string	No	MANUAL
data.authorizationType	string	No	FINAL_AUTH
data.currency	string	Yes	标价币种，大写字母，参见【交易支持国家/地区与币种】
data.country	string	Yes	国家代码，大写字母，参见【交易支持国家/地区与币种】。 如指定了paymentMethodType，则国家代码必须上送且和支付方式对应国家匹配。 收银台可用国家地区选择策略为：上送国家代码地区>用户历史使用国家代码地区>用户IP所在国家代码地区。（可用国家地区：交易币种对应的国家与签约国家取交集）
data.userId	string	Yes	商户内部的用户Id，需要保证每个ID唯一性。支付方式绑定后会根据userId进行支付方式推荐
data.referralCode	string	No	用于更精准的支付方式推荐，如设备ID、设备指纹等。
data.componentList	array[string]	No	如：CARD，APPLEPAY

Responses

200

Field	Type	Required	Description
code	string	Yes
msg	string	Yes
data	返回数据体	Yes
data.sessionKey	string	Yes	Drop-in
data.clientKey	string	Yes	前端SDK初始化参数

Enum Reference

data.mitType

• SCHEDULED
• UNSCHDULED