Pagos con Boleto

Para aceptar pagos con Boleto, la sesión de Checkout debe cumplir todas estas condiciones:

• Los precios de todos los ítems de factura deben estar expresados en la misma moneda. Si tienes ítems en otras monedas, crea sesiones de Checkout separadas para cada moneda.
• Solo puedes utilizar ítems de partida puntuales (no se aceptan planes de suscripción recurrentes).

Utiliza esta guía para aprender a habilitar Boleto. Muestra las diferencias entre aceptar un pago con tarjeta y usar Boleto.

Habilitar Boleto como método de pago

Al crear una nueva sesión de Checkout, debes:

1. Agregar boleto a la lista de payment_method_types
2. Asegúrate de que todos los line_items usen la moneda brl.

Stripe::Checkout::Session.create({
  mode: 'payment',
  payment_method_types: ['card'],
  payment_method_types: ['card', 'boleto'],
  # The parameter is optional. The default value of expires_after_days is 3.
  payment_method_options: {
    boleto: {
      expires_after_days: 7
    }
  },
  line_items: [{
    price_data: {
      # To accept `boleto`, all line items must have currency: brl
      currency: 'brl',
      product_data: {
        name: 'T-shirt',
      },
      unit_amount: 2000,
    },
    quantity: 1,
  }],
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

Opciones de métodos de pago adicionales

Puedes especificar un parámetro opcional expires_after_days en las opciones de métodos de pago de tu Session para definir la cantidad de días calendario que deben pasar para que venza el vale de Boleto. Por ejemplo, si creas un vale de Boleto un lunes y defines expires_after_days en 2, el vale vence el miércoles a las 23:59, hora de América/Sao_Paulo (UTC-3). Si lo defines en 0, el vale de Boleto vencerá al final del día. El parámetro expires_after_days puede ser de 0 a 60 días. El valor predeterminado es de 3 días. Puedes personalizar los días de vencimiento predeterminados en tu cuenta en la configuración de métodos de pago

Redireccionamiento a la página del vale alojada por Stripe

Después de enviar el formulario de Checkout correctamente, se redirige al cliente a la hosted_voucher_url. El cliente puede copiar el número del Boleto o descargar el vale en PDF desde la página del vale alojada.

Stripe envía un evento payment_intent.requires_action cuando se crea correctamente el vale de Boleto. Si necesitas enviar a tus clientes el enlace del vale por correo electrónico, puedes localizar la hosted_voucher_url en payment_intent.next_action.boleto_display_details. Obtén más información sobre cómo supervisar un PaymentIntent con webhooks.

Stripe permite la personalización de las interfaces de usuario del cliente en la página configuración de imagen de marca. Se puede aplicar la siguiente configuración de imagen de marca al vale:

• Ícono: tu imagen de marca y el nombre público de la empresa
• Color de énfasis: Se utiliza como color del botón Copiar número
• Color de la marca: se utiliza como color de fondo

Completar tus pedidos

Debido a que Boleto es un método de pago con notificación diferida, tienes que usar un método como los webhooks para monitorear el estado del pago y manejar la gestión logística del pedido. Obtén más información sobre cómo configurar webhooks y completar pedidos.

Los siguientes eventos se envían cuando cambia el estado del pago:

Al probar tu integración de Checkout, selecciona Boleto como método de pago y haz click en el botón Pagar.

Los pagos con Boleto no se pueden rembolsar. Algunos comerciantes han creado un proceso aparte para devolverles el importe a los clientes que se contactan de forma directa.

El cliente no puede disputar los pagos con Boleto.