Pagos con Boleto

Para admitir pagos con Boleto, la sesión de proceso de compra debe cumplir con las siguientes 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.

Esto te orienta para habilitar Boleto y muestra las diferencias entre aceptar pagos con métodos de pago dinámicos y configurar métodos de pago manualmente.

Habilitar Boleto como método de pago

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

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

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=brl \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=boleto \
  --data-urlencode success_url="https://example.com/success"

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 la sesión para establecer la cantidad de días calendario antes de que un vale Boleto venza. Por ejemplo, si creas un vale Boleto el lunes y establece expires_after_days en 2, el vale vencerá el miércoles a las 23:59, hora de Estados Unidos/Sao_Paulo (UTC-3). Si lo estableces en 0, el vale vence al final del día. El parámetro expires_after_days puede configurarse entre 0 y 60 días. El valor predeterminado es de 3 días. Puedes personalizar los días de vencimiento predeterminados en tu cuenta en Configuración de métodos de pago.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=brl \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_method_options[boleto][expires_after_days]"=7 \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=boleto \
  --data-urlencode success_url="https://example.com/success"

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.