支付方式构建说明
e-wallet
在 创建交易 中,当 paymentMethod.type 为 e-wallet 时,须在 paymentMethod.e-wallet 对象内填写 paymentBrand(JSON 键名为 "e-wallet"),与 type 配合指定电子钱包渠道。
数据结构与请求样例
以下为 paymentMethod.type = e-wallet 时请求体中与品牌相关的核心结构(WEB 场景:transInitiator 仅需 terminalType)。完整字段、校验规则与其它示例见 创建交易。
{
"merchantOrderId": "M202512180001",
"amount": {
"value": "1099",
"currency": "PHP"
},
"country": "PH",
"transInitiator": {
"terminalType": "WEB"
},
"paymentMethod": {
"type": "e-wallet",
"e-wallet": {
"paymentBrand": "gcash"
}
},
"notifyUrl": "https://merchant.com/webhook/payment"
}支持的支付品牌
当 paymentMethod.type 为 e-wallet 时,支持以下 paymentBrand:
| 国家/地区 | 支付方式 | 枚举值 | 支付方式类型 |
|---|---|---|---|
| 印度尼西亚 | DANA | dana | 电子钱包 |
| OVO | ovo | 电子钱包 | |
| ShopeePay | shopeepay | 电子钱包 | |
| LinkAja | linkaja | 电子钱包 | |
| ePay | epay | 电子钱包 | |
| 菲律宾 | GCash | gcash | 电子钱包 |
| 埃及 | Vodafone | vodafone | 电子钱包 |
| 约旦 | eFawateercom | efawateercom | 电子钱包 |
| 沙特阿拉伯 | STCPAY | stcpay | 电子钱包 |
qr
在 创建交易 中,当 paymentMethod.type 为 qr 时,须在 paymentMethod.qr 对象内填写 paymentBrand,与 type 配合指定二维码支付渠道。
数据结构与请求样例
以下为 paymentMethod.type = qr 时请求体中与品牌相关的核心结构(WEB 场景:transInitiator 仅需 terminalType)。完整字段、校验规则与其它示例见 创建交易。
{
"merchantOrderId": "M202512180001",
"amount": {
"value": "1099",
"currency": "PHP"
},
"country": "PH",
"transInitiator": {
"terminalType": "WEB"
},
"paymentMethod": {
"type": "qr",
"qr": {
"paymentBrand": "qris"
}
},
"notifyUrl": "https://merchant.com/webhook/payment"
}支持的支付品牌
当 paymentMethod.type 为 qr 时,支持以下 paymentBrand:
| 国家/地区 | 支付方式 | 枚举值 | 支付方式类型 |
|---|---|---|---|
| 印度尼西亚 | QRIS | qris | 实时支付 |
onlineBanking
在 创建交易 中,当 paymentMethod.type 为 onlineBanking 时,须在 paymentMethod.onlineBanking 对象内填写 paymentBrand,与 type 配合指定网银渠道。
数据结构与请求样例
以下为 paymentMethod.type = onlineBanking 时请求体中与品牌相关的核心结构(WEB 场景:transInitiator 仅需 terminalType)。完整字段、校验规则与其它示例见 创建交易。
{
"merchantOrderId": "M202512180001",
"amount": {
"value": "1099",
"currency": "GBP"
},
"country": "GB",
"transInitiator": {
"terminalType": "WEB"
},
"paymentMethod": {
"type": "onlineBanking",
"onlineBanking": {
"paymentBrand": "online_banking"
}
},
"notifyUrl": "https://merchant.com/webhook/payment"
}支持的支付品牌
当 paymentMethod.type 为 onlineBanking 时,支持以下 paymentBrand:
| 国家/地区 | 支付方式 | 枚举值 | 支付方式类型 |
|---|---|---|---|
| 奥地利 | EPS | eps | 在线支付 |
| 荷兰 | iDeal | ideal | 在线支付 |
| 波兰 | PayU | payu | 在线支付 |
| Przelewy24 | p24 | 在线支付 | |
| 葡萄牙 | Multibanco | multibanco | 在线支付 |
| 俄罗斯 | Tinkoff Bank | tinkoffbank | 在线支付 |
| 英国 | Online Banking | online_banking | 在线支付 |
| 说明:该 `paymentBrand` 会根据所传 `country` 选择收单机构;`GB` 对应的组织机构为:`TRL`。 | |||
| 澳大利亚 | Online Banking | online_banking | 在线支付 |
| 说明:该 `paymentBrand` 会根据所传 `country` 选择收单机构;`AU` 对应的组织机构为:`PID`。 | |||
bankTransfer
在 创建交易 中,当 paymentMethod.type 为 bankTransfer 时,须在 paymentMethod.bankTransfer 对象内填写 paymentBrand,与 type 配合指定银行转账渠道。
数据结构与请求样例
以下为 paymentMethod.type = bankTransfer 时请求体中与品牌相关的核心结构(WEB 场景:transInitiator 仅需 terminalType)。完整字段、校验规则与其它示例见 创建交易。
{
"merchantOrderId": "M202512180001",
"amount": {
"value": "1099",
"currency": "RUB"
},
"country": "RU",
"transInitiator": {
"terminalType": "WEB"
},
"paymentMethod": {
"type": "bankTransfer",
"bankTransfer": {
"paymentBrand": "sbp"
}
},
"notifyUrl": "https://merchant.com/webhook/payment"
}支持的支付品牌
当 paymentMethod.type 为 bankTransfer 时,支持以下 paymentBrand:
| 国家/地区 | 支付方式 | 枚举值 | 支付方式类型 |
|---|---|---|---|
| 俄罗斯 | SBP | sbp | 银行转账 |