Aceptar una transferencia bancaria

La sesión de Checkout debe cumplir las siguientes condiciones para aceptar Bank Transfer pagos:

• 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 únicos (las sesiones de Checkout para transferencias bancarias no aceptan planes de suscripción recurrentes).

Usa esta guía para habilitar Bank Transfer.

Crear o recuperar un objeto Customer

You must associate a Customer object to reconcile each bank transfer payment. If you have an existing Customer object, you can skip this step. Otherwise, create a new Customer object.

curl -X POST https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Habilitar Bank Transfer como método de pago

When creating a new Checkout Session, you need to:

1. Configurar customer
2. Agregar customer_balance a la lista de payment_method_types
3. Verifica que todos los line_items usen la misma moneda.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "line_items[0][price_data][currency]"=usd \
  -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]"=customer_balance \
  -d "payment_method_options[customer_balance][funding_type]"=bank_transfer \
  -d "payment_method_options[customer_balance][bank_transfer][type]"=us_bank_transfer \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/failure"

Redireccionamiento a la página alojada de instrucciones para transferencias bancarias de Stripe

Después de enviar satisfactoriamente el formulario de Checkout,

• If the customer already has a balance high enough to cover the request amount, the payment immediately succeeds and the customer is redirected to the success_url.
• If the customer balance isn’t high enough to cover the request amount, the customer is redirected to the hosted_instructions_url. The page has the instructions to guide your customer through completing the transfer.

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 a la página de instrucciones alojada:

• Icon—your brand image and public business name
• Color de la marca: se utiliza como color de fondo

Completa los pedidos

Because bank transfer is a delayed notification payment method, you need to use a method such as webhooks to monitor the payment status and handle order fulfillment. Learn more about setting up webhooks and fulfilling orders.

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

Puedes probar tu integración simulando una transferencia bancaria entrante con la API, a través del Dashboard o con una versión beta de la CLI de Stripe.