纯API支付DDC申请
- Endpoint:
POST /aggregate-pay/api/gateway/applyDDC - Tags: 收单
Description
API模式接入的商户追求极致的用户体验,减少支付流程耗时,降低用户3DS认证放弃率。 在卡号收集阶段,静默调用此接口完成设备信息采集。
Parameters
| Field | Type | Required | Description |
|---|---|---|---|
Content-Type (header) | string | Yes | |
sign (header) | string | Yes | 签名信息请参考技术文档 |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
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 | object | Yes | 请求数据体 |
data.paymentMethodType | string | Yes | 支付方式类型,枚举值:CARD、GOOGLEPAY |
data.paymentAmount | number | Yes | 交易金额,金额的单位为元。换汇场景使用换汇后的金额 |
data.paymentCurrency | string | Yes | 交易币种,大写字母。换汇场景使用换汇后的币种 |
data.userId | string | Yes | 商户内部的用户Id,需要保证每个ID唯一性。 |
data.cardIdentifierNo | string | No | 卡号,明文卡号或GOOGLEPAY解密出来的卡号。和paymentTokenID二选一 |
data.paymentTokenID | string | No | PMMax token ID,授权成功后支付。和cardIdentifierNo二选一 |
Responses
200
| Field | Type | Required | Description |
|---|---|---|---|
code | string | Yes | 返回码,’APPLY_SUCCESS’代表成功。只代表接口请求成功,不代表订单状态。 |
msg | string | Yes | 返回描述,’Success.’。只代表接口请求成功,不代表订单状态。 |
data | object | No | 返回数据体 |
data.ddcSessionId | ['string', 'null'] | No | 接口orderAndPay时需要携带此字段 |
data.ddcUrl | ['string', 'null'] | No | 加载ddc的地址,商户客户端在隐藏iframe中加载此url |
