SEPA

SEPA 是在欧元区使用的电子商务支付系统，让付款人可以从其银行账户使用直接借记支付来购物。 付款人被重定向到 PPRO，付款人接受屏幕上显示的授权，从而触发通过电子邮件发送的支付预先通知，以及从其账户扣除付款。

SEPA 是一种受 Mastercard Gateway 支持的浏览器付款方式。 此页内容介绍特定于 SEPA 的集成详细信息。 建议您在构建 SEPA 集成前，先阅读浏览器付款集成指南。

SEPA 浏览器付款仅支持使用 EUR 货币的交易。

目前不支持 SEPA 定期付款。

先决条件 Copied to Clipboard

若要通过 Mastercard Gateway 作为付款方式提供 SEPA：

  • 您必须向您的浏览器付款服务提供商注册。
  • 您在网关上的商家配置文件必须通过浏览器付款服务提供商使用您的账户的详细信息配置。
  • 您必须有使用支持的货币之一的银行账户，且该账户已向您在浏览器付款服务提供商处的商家账户注册。

SEPA 集成 Copied to Clipboard

通过 Hosted Checkout 使用 SEPA

不久之后将实现通过 Hosted Checkout 使用 SEPA。 请联系 your payment service provider 了解更多信息。

通过 Direct Payment 使用 SEPA

Direct Payment 集成可让您在自己的结账页提供 SEPA 付款方式。

从 DirectAPI 版本 47 开始支持 SEPA。

除浏览器付款请求中需要的标准字段外，您还需要在 Initiate Browser Payment 请求中提供以下字段：

  • sourceOfFunds.type = SEPA
  • browserPayment.operation = PAY（SEPA 不支持 Authorize 操作）
  • customer.email: 付款人的电子邮件地址。
  • sourceOfFunds.provided.sepa.bankAccountHolder: 付款人银行账户的银行账户所有人姓名。
  • sourceOfFunds.provided.sepa.iban: 付款人银行账户的国际银行账号 (IBAN)。

首选语言

您可以通过在 Initiate Browser Payment 请求中提供 browserPayment.preferredLanguage 字段来设置 SEPA 为向付款人显示的页面使用的首选语言。 不过，此语言只有在 SEPA 支持时才能够使用。

退单

SEPA 付款存在退单风险。如果付款人对付款有异议，并且通过其银行成功创建了退单，此事件将在网关中体现，并会在 transaction.dispute.reason 字段中提供原因。 有关更多信息，请参阅退单交易。

发起 SEPA 付款的示例代码

{
    "apiOperation":"INITIATE_BROWSER_PAYMENT",
    "browserPayment":{
    "operation":"PAY",
    "returnUrl":"https://<return_url>"
},
    "customer": {
    "email": "john.smith@example.com"
  },
  "order": {
    "amount": "10.00",
    "currency": "EUR"
  },
  "sourceOfFunds": {
    "type": "SEPA",
    "provided": {
      "sepa": {
        "iban": "GB33BUKB20201555555555",
        "bankAccountHolder": "John Smith"
      }
    }
  }
}

如何解释交易结果 Copied to Clipboard

下表显示了在发起 SEPA 付款后您可能遇到的可能出现的情景的交易响应代码。

Initiate Browser Payment 响应
 具体含义...
response.gatewayCode=SUBMITTED
result=SUCCESS		 使用响应中提供的 URL 重定向付款人。
Retrieve Transaction/Retrieve Order 响应
具体含义...
response.gatewayCode=APPROVED
result=SUCCESS
sourceOfFunds.provided.sepa.bankAccountHolder
sourceOfFunds.provided.sepa.iban sourceOfFunds.provided.sepa.bic 		付款成功。
response.gatewayCode=PENDING
result=PENDING
 Mastercard Gateway 等待来自收单行的付款结果通知。 稍后重试 RETRIEVE_TRANSACTION 或接收来自 Mastercard Gateway 的通知。
response.gatewayCode=CANCELLED
result=FAILURE		 付款人已取消此付款的交互。 为付款人提供尝试其他付款方式的选项。
response.gatewayCode=DECLINED or ACQUIRER_SYSTEM_ERROR
result=FAILURE		 付款被拒绝。 为付款人提供尝试其他付款方式的选项。
如果出现 ACQUIRER_SYSTEM_ERROR，您可能需要询问收单行付款失败的原因，也可以重试 RETRIEVE_TRANSACTION。
response.gatewayCode=TIMED_OUT
result=FAILURE		 请将此情况视为被拒付款。 Mastercard Gateway 将进行尝试以确保交易不成功或撤消交易。

退款 Copied to Clipboard

您可以部分或全部退还 SEPA 付款。 您必须在网关以及您在 APM 服务提供商处的商家账户中进行退款配置。

测试您的集成 Copied to Clipboard

Mastercard Gateway 提供允许您测试您的 SEPA 集成的浏览器付款模拟器。