- 集成指南
- 支持的功能（付款方式）
- 实施浏览器付款集成
- Boleto Bancário 支付
Boleto Bancário
Boleto Bancário 是在巴西使用的电子商务支付系统，让付款人可以使用现金付款或通过在线银行付款来购物。 当付款人在结账页面选择 Boleto Bancário 并继续使用现金付款时，付款详细信息将显示在屏幕上并可以打印。 然后，付款人可以在 Boleto Bancário 网点支付购物金额。 对于在线银行付款，付款人输入 Boleto Bancário 详细信息，然后审核并授权付款。 在这两种情况下，付款完成后，您都会收到通知，商品随后会运送给付款人。
Boleto Bancário 是一种受 QNB ALAHLI 支持的浏览器付款方式。 此页内容介绍特定于 Boleto Bancário 的集成详细信息。 建议您在构建 Boleto Bancário 集成前，先阅读浏览器付款集成指南。
Boleto Bancário 浏览器付款仅支持使用 USD 货币的交易。
- 由于安全原因，在 QNB ALAHLI 上访问 Boleto 的时间只能持续 48 小时，或最多只能访问 5 次，之后将无法再访问。 Boleto 付款的过期时间基于您的配置。
- Boleto 始终会生成一个 PDF 文件。 如果您需要付款人能够在更长时间内使用这些文件，必须将文件的副本保存在本地服务器上。
先决条件
若要通过 QNB ALAHLI 作为付款方式提供 Boleto Bancário：
- 您必须向您的浏览器付款服务提供商注册。
- 您在网关上的商家配置文件必须通过浏览器付款服务提供商使用您的账户的详细信息配置。
- 您必须有使用支持的货币之一的银行账户，且该账户已向您在浏览器付款服务提供商处的商家账户注册。
Boleto Bancário 集成
不久之后将实现通过 <<checkout>> 使用 Boleto Bancário。 请联系 your payment service provider 了解更多信息。
<<directPayment>> 集成可让您在自己的结账页提供 Boleto Bancário 付款方式。
除浏览器付款请求中需要的标准字段外，您还需要在 Initiate Browser Payment 请求中提供以下字段：
sourceOfFunds.type=BOLETO_BANCARIObrowserPayment.operation=PAY（Boleto Bancário 不支持 Authorize 操作）billing.address.*: 付款人账单地址的详细信息。customer.email: 付款人的电子邮件地址。customer.account.id: 付款人在您这里的账户的标识符。customer.nationalId: 政府机构分配的付款人标识符。sourceOfFunds.provided.boletoBancario.bankAccountHolder: 付款人银行账户的银行账户所有人姓名。
首选语言
您可以通过在 Initiate Browser Payment 请求中提供 browserPayment.preferredLanguage 字段来设置 Boleto Bancário 为向付款人显示的页面使用的首选语言。 不过，此语言只有在 Boleto Bancário 支持时才能够使用。
{
"apiOperation": "INITIATE_BROWSER_PAYMENT",
"billing": {
"address": {
"street": "10 Upper Bank Street",
"postcodeZip": "E14 5NP",
"city": "London",
"country": "GBR"
}
},
"browserPayment": {
"operation": "PAY",
"returnUrl": "<your_merchant_URL>"
},
"customer": {
"email": "john.smith@example.com",
"account": {
"id": "1234567890"
},
"nationalId": "1234567890"
},
"order": {
"amount": "10.00",
"currency": "USD"
},
"sourceOfFunds": {
"type": "BOLETO_BANCARIO",
"provided": {
"boletoBancario": {
"bankAccountHolder": "John Smith"
}
}
}
}
如何解释交易结果
下表显示了在发起 Boleto Bancário 付款后您可能遇到的可能出现的情景的交易响应代码。
| Initiate Browser Payment 响应 | 具体含义... |
|---|---|
response.gatewayCode=SUBMITTEDresult=SUCCESS |
使用响应中提供的 URL 重定向付款人。 |
| Retrieve Transaction/Retrieve Order 响应 | 具体含义... |
response.gatewayCode=APPROVEDresult=SUCCESS |
付款成功。 |
response.gatewayCode=PENDINGresult=PENDING |
QNB ALAHLI 等待来自收单行的付款结果通知。 稍后重试 RETRIEVE_TRANSACTION 或接收来自 QNB ALAHLI 的通知。 |
response.gatewayCode=CANCELLEDresult=FAILURE |
付款人已取消此付款的交互。 为付款人提供尝试其他付款方式的选项。 |
response.gatewayCode=DECLINED 或 ACQUIRER_SYSTEM_ERRORresult=FAILURE |
付款被拒绝。 为付款人提供尝试其他付款方式的选项。 如果出现 ACQUIRER_SYSTEM_ERROR，您可能需要询问收单行付款失败的原因，也可以重试 RETRIEVE_TRANSACTION。 |
response.gatewayCode=TIMED_OUTresult=FAILURE |
请将此情况视为被拒付款。 QNB ALAHLI 将进行尝试以确保交易不成功或撤消交易。 |
测试您的集成
QNB ALAHLI 提供允许您测试您的 Boleto Bancário 集成的浏览器付款模拟器。