创建订阅支付
TIP
POST baseUrl + /subsApi/newSubs
HTTP请求头
| 请求头 | 必选 | 值 |
|---|---|---|
Content-Type | Y | application/json |
MerchantId | Y | MerchantId |
Sign | Y | Sign |
HTTP请求体
| 参数名 | 必选 | 类型 | 示例值 | 说明 |
|---|---|---|---|---|
currency | Y | string(32) | COP | 货币代码(COP) |
payType | Y | int | 171 | 订阅支付类型 NEQUI订阅=171 |
mchOrderNo | Y | string(32) | mchOrderNo1234 | 商户订单号（不允许重复） |
nonceStr | Y | string(32) | xxxxxxxxxx | 随机字符串 |
realName | Y | string(32) | Jeck | 用户姓名不能有特殊字符、限制最长64个字符 |
phone | Y | string(32) | +57xxxxxxx | 手机号注册App的手机号才能收到订阅请求 |
email | Y | string(64) | example@gmail.com | 邮箱 邮箱格式要正确,尽量传真实的邮箱 |
idType | Y | string(32) | 1 请参考证件类型 | 客户证件类型 |
idCard | Y | string(32) | 错误的证件号可能导致部分交易失败 | 客户证件号 |
remark | N | string(32) | 不传默认 remark | 备注 （请使用英文字符或不带重音的西语） |
TIP
注意: 请求频率建议控制在1秒1次，上游渠道接口有限速
发起订阅后需要客户在App内点击同意授权
HTTP响应体
| 参数名 | 类型 | 说明 |
|---|---|---|
merchantId | long | 商户Id |
mchOrderNo | string(32) | 商户订单号 |
orderNo | string(32) | 平台订单号 |
payCode | string(32) | 订阅客户手机号 |
subsStatus | string(32) | 订单状态(订阅状态)（WAITING=等待 APPROVE=批准 REJECT=拒绝 EXPIRED=过期 CANCEL=取消 FAIL=失败） |
json
{
"msg": "SUCCESS",
"code": 200,
"data": {
"merchantId": "100001",
"mchOrderNo": "M1656908719283",
"orderNo": "SUBS8232154612109344768",
"payCode": "+57xxxxxxxxx",
"subsStatus": "WAITING"
}
}