- Pautas de integración
- Características soportadas (métodos de pago)
- Implementación de una integración de pago mediante explorador
- Pagos con Boleto Bancário
Boleto Bancário
Boleto Bancário es un sistema de pago de comercio electrónico utilizado en Brasil, que permite a los pagadores comprar mediante pagos en efectivo o a través de pagos bancarios en línea. Cuando el pagador selecciona Boleto Bancário en la página de pago y va a realizar un pago en efectivo, los detalles del pago se muestran en pantalla y se pueden imprimir. Luego, el pagador puede pagar el monto requerido para la compra en un local de Boleto Bancário. Para los pagos bancarios en línea, el pagador ingresa los datos de Boleto Bancário y revisa y autoriza el pago. En ambos casos, una vez que se realice el pago, recibirá una notificación y los bienes se podrán entregar para ser enviados al pagador.
Boleto Bancário es un método de pago mediante explorador compatible en el Mastercard Gateway. Esta página describe los detalles de integración específicos de Boleto Bancário. Se recomienda que lea las pautas de integración para los pagos mediante explorador antes de crear una integración de Boleto Bancário.
Los pagos mediante explorador de Boleto Bancário solo se admiten para transacciones en la moneda USD.
- Por razones de seguridad, solo se puede acceder a Boleto en el Mastercard Gateway durante 48 horas o un máximo de cinco veces, después de lo cual, Boleto ya no estará disponible. El pago de Boleto vencerá según su configuración.
- Los boletos siempre se generan como archivos PDF. Si necesita que estos archivos estén disponibles para los pagadores durante un período prolongado, debe guardar copias de ellos en su servidor local.
PrerrequisitosCopied to Clipboard
Para ofrecer Boleto Bancário como un método de pago mediante Mastercard Gateway:
- Usted debe estar registrado con su proveedor de servicios de pago mediante explorador.
- Su perfil de negocio en el motor de pagos se debe configurar usando los detalles de su cuenta con el proveedor de servicios de pago mediante explorador.
- Debe tener una cuenta bancaria en una de las monedas soportadas registrada en su cuenta de negocio en su proveedor de servicios de pago mediante explorador.
Integración de Boleto BancárioCopied to Clipboard
Boleto Bancário por medio de Hosted Checkout estará disponible próximamente. Póngase en contacto con your payment service provider para obtener más información.
La integración de Direct Payment le permite ofrecer el método de pago Boleto Bancário en su propia página de pago.
Además de los campos estándar obligatorios en una solicitud de pago mediante explorador, debe completar los siguientes campos en la solicitud Initiate Browser Payment
:
sourceOfFunds.type
=BOLETO_BANCARIO
browserPayment.operation
=PAY
(Boleto Bancário no admite la operación Authorize).billing.address.*
: detalles de la dirección de facturación del pagador.customer.email
: la dirección de correo electrónico del pagador.customer.account.id
: el identificador de la cuenta que tiene el pagador con usted.customer.nationalId
: un identificador para el pagador asignado por una autoridad gubernamental.sourceOfFunds.provided.boletoBancario.bankAccountHolder
: el nombre del titular de la cuenta bancaria para la cuenta bancaria del pagador.
Idioma preferido
Para configurar el idioma que prefiere que Boleto Bancário utilice para las páginas que se muestran al pagador, complete el campo browserPayment.preferredLanguage
en la solicitud de Initiate Browser Payment. Sin embargo, el idioma se usará solo si Boleto Bancário lo admite.
{ "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" } } } }
Cómo interpretar el resultado de la transacciónCopied to Clipboard
La tabla siguiente muestra los códigos de respuesta de transacción para los posibles escenarios que puede encontrar después de iniciar un pago con Boleto Bancário.
Respuesta de Initiate Browser Payment | ¿Qué significa esto? |
---|---|
response.gatewayCode=SUBMITTED result=SUCCESS |
Redirigir al pagador utilizando la URL proporcionada en la respuesta. |
Respuesta de Retrieve Transaction/Retrieve Order | Qué significa esto... |
response.gatewayCode=APPROVED result=SUCCESS |
El pago se realizó correctamente. |
response.gatewayCode=PENDING result=PENDING |
Mastercard Gateway está esperando una notificación del adquirente sobre el resultado del pago. Pruebe RETRIEVE_TRANSACTION nuevamente más tarde o escuche las notificaciones de Mastercard Gateway. |
response.gatewayCode=CANCELLED result=FAILURE |
El pagador canceló la interacción para este pago. Ofrezca al pagador la opción de probar otro método de pago. |
response.gatewayCode=DECLINED o ACQUIRER_SYSTEM_ERROR result=FAILURE |
El pago fue rechazado. Ofrezca al pagador la opción de probar otro método de pago. En caso de un ACQUIRER_SYSTEM_ERROR , puede consultar con el adquirente el motivo del error del pago, o bien puede intentar RETRIEVE_TRANSACTION de nuevo. |
response.gatewayCode=TIMED_OUT result=FAILURE |
Trate esto como un pago rechazado. El Mastercard Gateway hará lo posible para asegurarse de que la transacción no se puede realizar o revertirá la transacción. |
Prueba de su integraciónCopied to Clipboard
Mastercard Gateway proporciona un emulador de pagos mediante explorador que le permite probar su integración con Boleto Bancário.