- 集成指南
- 支持的功能（付款方式）
- 实施浏览器付款集成
- Multibanco 支付
Multibanco
Multibanco 是在葡萄牙使用的付款方式。 使用 Multibanco，消费者可以通过银行转账或通过在 ATM 上使用 Multibanco 卡为一些商品或服务付款，包括电子商务、许可证和税款。
Multibanco 是一种受 Mastercard Gateway 支持的浏览器付款方式。 此页内容介绍特定于 Multibanco 的集成详细信息。 建议您在构建 Multibanco 集成前，先阅读浏览器付款集成指南。
Multibanco 浏览器付款仅支持使用 EUR 货币的交易。
先决条件
要通过 Mastercard Gateway 作为付款方式提供 Multibanco：
- 您必须向您的浏览器付款服务提供商注册
- 您在网关上的商家配置文件必须通过浏览器付款服务提供商使用您的账户的详细信息配置，并且
- 您必须有使用支持的货币之一的银行账户，且该账户已向您在浏览器付款服务提供商处的商家账户注册。
Multibanco 集成
Hosted Checkout 集成让您可以通过网关托管和显示的交互来从付款人处收集付款详细信息。
从 API 版本 65 开始，在 your payment service provider 为您启用并配置了 Multibanco 后，它会自动成为付款方式之一。
有关详细信息，请参阅通过 Hosted Checkout 集成进行浏览器付款。
Direct Payment 集成可让您在自己的结账页提供 Multibanco 付款方式。
在 sourceOfFunds.type = MULTIBANCO 且 browserPayment.operation = PAY 时发起 Initiate Browser Payment 请求（Multibanco 不支持 Authorize 操作）。 对于标准字段，请参阅通过 Direct Payment 集成进行浏览器付款。
在您发起 Multibanco 付款后，以下字段将在 Initiate Browser Payment/Retrieve Transaction/Retrieve Order 响应中返回。
sourceOfFunds.provided.multibanco.entityId: 您在 Multibanco 的商家识别码。sourceOfFunds.provided.multibanco.paymentReference: Multibanco 付款的标识符。
您必须向付款人提供这些字段来完成付款。
首选语言
您可以通过在 Initiate Browser Payment 请求中提供 browserPayment.preferredLanguage 字段来设置 Multibanco 为向付款人显示的页面使用的首选语言。 不过，此语言只有在 Multibanco 支持时才能够使用。
{
"apiOperation":"INITIATE_BROWSER_PAYMENT",
"browserPayment":{
"operation":"PAY",
"returnUrl":"<your_merchant_URL>"
},
"order":{
"amount":"10.00",
"currency":"EUR"
},
"sourceOfFunds":{
"type":"MULTIBANCO"
}
}
如何解释交易结果
下表显示了在发起 Multibanco 付款后您可能遇到的可能出现的情景的交易响应代码。
Initiate Browser Payment 响应 |
具体含义... |
|---|---|
response.gatewayCode=SUBMITTEDresult=SUCCESS |
使用响应中提供的 URL 重定向付款人。 |
Retrieve Transaction/Retrieve Order 响应 |
具体含义... |
response.gatewayCode=APPROVEDresult=SUCCESSsourceOfFunds.provided.multibanco.terminalLocationsourceOfFunds.provided.multibanco.terminalId |
付款成功。 |
response.gatewayCode=PENDINGresult=PENDING |
Mastercard Gateway 等待来自收单行的付款结果通知。 稍后重试 RETRIEVE_TRANSACTION 或接收来自 Mastercard Gateway 的通知。 |
response.gatewayCode=CANCELLEDresult=FAILURE |
付款人已取消此付款的交互。 为付款人提供尝试其他付款方式的选项。 |
response.gatewayCode=DECLINED or ACQUIRER_SYSTEM_ERRORresult=FAILURE |
付款被拒绝。 为付款人提供尝试其他付款方式的选项。 如果出现 ACQUIRER_SYSTEM_ERROR，您可能需要询问收单行付款失败的原因，也可以重试 RETRIEVE_TRANSACTION。 |
response.gatewayCode=TIMED_OUTresult=FAILURE |
请将此情况视为被拒付款。 网关将进行尝试以确保交易不成功或撤消交易。 |
测试您的集成
Mastercard Gateway 提供允许您测试您的 Multibanco 集成的浏览器付款模拟器。