- 集成指南
- 支持的功能（付款方式）
- 实施浏览器付款集成
- Bancontact 付款
Bancontact
Bancontact 是比利时的一种实时的网上银行转账付款方式。 Bancontact 是一种受支持的浏览器付款方式 Mastercard Gateway。 此页内容介绍特定于 Bancontact 的集成详细信息。
建议您在构建 Bancontact 集成前，先阅读浏览器付款集成指南。
Bancontact 浏览器付款仅支持使用 EUR 货币的交易。
先决条件
要通过 Mastercard Gateway 提供 Bancontact 付款方式，
- 您必须向您的浏览器付款服务提供商注册
- 您在 Mastercard Gateway 上的商家配置文件必须通过浏览器付款服务提供商使用您的账户的详细信息配置，以及
- 您必须有使用支持的货币之一的银行账户，且该账户已向您在浏览器付款服务提供商处的商家账户注册。
Bancontact 集成
Hosted Checkout 集成让您可以通过 Mastercard Gateway 托管和显示的交互来从付款人处收集付款详细信息。
从 API 版本 65 开始，在 your payment service provider 为您启用并配置了 Bancontact 后，它会自动成为付款方式之一。
有关详细信息，请参阅通过 Hosted Checkout 集成进行浏览器付款。
Direct Payment 集成可让您在自己的结账页提供 Bancontact 付款方式。
除浏览器付款请求中需要的标准字段外，您还需要在 Initiate Browser Payment 请求中提供以下字段：
通用字段
sourceOfFunds.type=BANCONTACTbrowserPayment.operation=PAY (Bancontact does not support the Authorize operation)customer.email=Email address of a payersourceOfFunds.provided.bancontact.bankAccountHolder= 付款人银行账户的银行账户所有人姓名
首选语言
您可以通过在 Initiate Browser Payment 请求中提供 browserPayment.preferredLanguage 字段来设置 Bancontact 为向付款人显示的页面使用的首选语言。 不过，此语言只有在 Bancontact 支持时才能够使用。
{
"apiOperation":"INITIATE_BROWSER_PAYMENT",
"browserPayment":{
"operation":"PAY",
"returnUrl":"<your_merchant_URL>"
},
"order":{
"amount":"10.00",
"currency":"EUR"
},
"sourceOfFunds":{
"type":"BANCONTACT",
"provided":{
"bancontact":{
"bankAccountHolder":"George Smith"
}
}
}
}
如何解释交易结果
此表指定了在发起 Bancontact 付款后您可能遇到的可能出现的情景的交易响应代码。
| Initiate Browser Payment 响应 | 具体含义... |
|---|---|
response.gatewayCode=SUBMITTEDresult=SUCCESS |
使用响应中提供的 URL 重定向付款人。 |
| Retrieve Transaction/Retrieve Order 响应 | 具体含义... |
response.gatewayCode=APPROVEDresult=SUCCESS |
付款成功。 |
response.gatewayCode=PENDINGresult=PENDING |
Mastercard Gateway 等待来自收单行的付款结果通知。 稍后重试 RETRIEVE_TRANSACTION 或接收来自 Mastercard Gateway 的通知。 |
response.gatewayCode=CANCELLEDresult=FAILURE |
付款人已取消此付款的交互。 为付款人提供尝试其他付款方式的选项。 |
response.gatewayCode=DECLINED 或 ACQUIRER_SYSTEM_ERRORresult=FAILURE |
付款被拒绝。 为付款人提供尝试其他付款方式的选项。 如果出现 ACQUIRER_SYSTEM_ERROR，您可能需要询问收单行付款失败的原因，也可以重试 RETRIEVE_TRANSACTION。 |
response.gatewayCode=TIMED_OUTresult=FAILURE |
请将此情况视为被拒付款。 Mastercard Gateway 将进行尝试以确保交易不成功或撤消交易。 |
退款
您可以通过分期付款方式或全额退还 Bancontact 付款。 确保您已在浏览器付款服务提供商处的商家账户上，在 Mastercard Gateway 上完成了退款配置。
测试您的集成
Mastercard Gateway 提供允许您测试您的 Bancontact 集成的浏览器付款模拟器。