Pagos con 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 Payment 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 Payment 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 caducará 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.

Prerrequisitos

Para ofrecer Boleto Bancário como un método de pago mediante Mastercard Payment 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ário

Boleto Bancário mediante Hosted Checkout

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.

Boleto Bancário mediante Direct Payment

La integración de Direct Payment le permite ofrecer el método de pago Boleto Bancário en su propia página de pago.

Boleto Bancário es compatible con API versión 50 en adelante.

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.

Código de muestra para iniciar el pago con 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"
      }
    }
  }
}

Cómo interpretar el resultado de la transacción

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 Payment 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 Payment 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 Payment Gateway hará lo posible para asegurarse de que la transacción no se puede realizar o revertirá la transacción.

Prueba de su integración

Mastercard Payment Gateway proporciona un emulador de pagos mediante explorador que le permite probar su integración con Boleto Bancário.

Derechos de autor © 2023 Mastercard