Skip to content

支付方式构建说明

e-wallet

创建交易 中,当 paymentMethod.typee-wallet 时,须在 paymentMethod.e-wallet 对象内填写 paymentBrand(JSON 键名为 "e-wallet"),与 type 配合指定电子钱包渠道。

数据结构与请求样例

以下为 paymentMethod.type = e-wallet 时请求体中与品牌相关的核心结构(WEB 场景:transInitiator 仅需 terminalType)。完整字段、校验规则与其它示例见 创建交易

json
{
  "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.typee-wallet 时,支持以下 paymentBrand

国家/地区支付方式枚举值支付方式类型
印度尼西亚DANAdana电子钱包
OVOovo电子钱包
ShopeePayshopeepay电子钱包
LinkAjalinkaja电子钱包
ePayepay电子钱包
菲律宾GCashgcash电子钱包
埃及Vodafonevodafone电子钱包
约旦eFawateercomefawateercom电子钱包
沙特阿拉伯STCPAYstcpay电子钱包

qr

创建交易 中,当 paymentMethod.typeqr 时,须在 paymentMethod.qr 对象内填写 paymentBrand,与 type 配合指定二维码支付渠道。

数据结构与请求样例

以下为 paymentMethod.type = qr 时请求体中与品牌相关的核心结构(WEB 场景:transInitiator 仅需 terminalType)。完整字段、校验规则与其它示例见 创建交易

json
{
  "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.typeqr 时,支持以下 paymentBrand

国家/地区支付方式枚举值支付方式类型
印度尼西亚QRISqris实时支付

onlineBanking

创建交易 中,当 paymentMethod.typeonlineBanking 时,须在 paymentMethod.onlineBanking 对象内填写 paymentBrand,与 type 配合指定网银渠道。

数据结构与请求样例

以下为 paymentMethod.type = onlineBanking 时请求体中与品牌相关的核心结构(WEB 场景:transInitiator 仅需 terminalType)。完整字段、校验规则与其它示例见 创建交易

json
{
  "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.typeonlineBanking 时,支持以下 paymentBrand

国家/地区支付方式枚举值支付方式类型
奥地利EPSeps在线支付
荷兰iDealideal在线支付
波兰PayUpayu在线支付
Przelewy24p24在线支付
葡萄牙Multibancomultibanco在线支付
俄罗斯Tinkoff Banktinkoffbank在线支付
英国Online Bankingonline_banking在线支付
说明:该 `paymentBrand` 会根据所传 `country` 选择收单机构;`GB` 对应的组织机构为:`TRL`。
澳大利亚Online Bankingonline_banking在线支付
说明:该 `paymentBrand` 会根据所传 `country` 选择收单机构;`AU` 对应的组织机构为:`PID`。

bankTransfer

创建交易 中,当 paymentMethod.typebankTransfer 时,须在 paymentMethod.bankTransfer 对象内填写 paymentBrand,与 type 配合指定银行转账渠道。

数据结构与请求样例

以下为 paymentMethod.type = bankTransfer 时请求体中与品牌相关的核心结构(WEB 场景:transInitiator 仅需 terminalType)。完整字段、校验规则与其它示例见 创建交易

json
{
  "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.typebankTransfer 时,支持以下 paymentBrand

国家/地区支付方式枚举值支付方式类型
俄罗斯SBPsbp银行转账

相关链接