- 集成指南
- 支持的功能（付款方式）
- 实施浏览器付款集成
- SEPA 支付
SEPA
SEPA 是在欧元区使用的电子商务支付系统，让付款人可以从其银行账户使用直接借记支付来购物。 付款人被重定向到 PPRO，付款人接受屏幕上显示的授权，从而触发通过电子邮件发送的支付预先通知，以及从其账户扣除付款。
SEPA 是一种受 QNB ALAHLI 支持的浏览器付款方式。 此页内容介绍特定于 SEPA 的集成详细信息。 建议您在构建 SEPA 集成前，先阅读浏览器付款集成指南。
SEPA 浏览器付款仅支持使用 EUR 货币的交易。
先决条件
若要通过 QNB ALAHLI 作为付款方式提供 SEPA：
- 您必须向您的浏览器付款服务提供商注册。
- 您在网关上的商家配置文件必须通过浏览器付款服务提供商使用您的账户的详细信息配置。
- 您必须有使用支持的货币之一的银行账户，且该账户已向您在浏览器付款服务提供商处的商家账户注册。
SEPA 集成
不久之后将实现通过 <<checkout>> 使用 SEPA。 请联系 your payment service provider 了解更多信息。
<<directPayment>> 集成可让您在自己的结账页提供 SEPA 付款方式。
除浏览器付款请求中需要的标准字段外，您还需要在 Initiate Browser Payment 请求中提供以下字段：
sourceOfFunds.type=SEPAbrowserPayment.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 字段中提供原因。 有关更多信息，请参阅退单交易。
{
"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"
}
}
}
}
如何解释交易结果
下表显示了在发起 SEPA 付款后您可能遇到的可能出现的情景的交易响应代码。
Initiate Browser Payment 响应 |
具体含义... |
|---|---|
response.gatewayCode=SUBMITTEDresult=SUCCESS |
使用响应中提供的 URL 重定向付款人。 |
Retrieve Transaction/Retrieve Order 响应 |
具体含义... |
response.gatewayCode=APPROVEDresult=SUCCESSsourceOfFunds.provided.sepa.bankAccountHoldersourceOfFunds.provided.sepa.iban sourceOfFunds.provided.sepa.bic
|
付款成功。 |
response.gatewayCode=PENDINGresult=PENDING |
QNB ALAHLI 等待来自收单行的付款结果通知。 稍后重试 RETRIEVE_TRANSACTION 或接收来自 QNB ALAHLI 的通知。 |
response.gatewayCode=CANCELLEDresult=FAILURE |
付款人已取消此付款的交互。 为付款人提供尝试其他付款方式的选项。 |
response.gatewayCode=DECLINED or ACQUIRER_SYSTEM_ERRORresult=FAILURE |
付款被拒绝。 为付款人提供尝试其他付款方式的选项。 如果出现 ACQUIRER_SYSTEM_ERROR，您可能需要询问收单行付款失败的原因，也可以重试 RETRIEVE_TRANSACTION。 |
response.gatewayCode=TIMED_OUTresult=FAILURE |
请将此情况视为被拒付款。 QNB ALAHLI 将进行尝试以确保交易不成功或撤消交易。 |
退款
您可以部分或全部退还 SEPA 付款。 您必须在网关以及您在 APM 服务提供商处的商家账户中进行退款配置。
测试您的集成
QNB ALAHLI 提供允许您测试您的 SEPA 集成的浏览器付款模拟器。