Acepta un pago con cargos y envíos de fondos separados.

Una sesión de Checkout controla lo que tu cliente puede ver en el formulario de pago, como las partidas, el importe y la moneda del pedido, así como los métodos de pago aceptados. Agrega un botón de pago en tu sitio web que llame a un punto de conexión del lado del servidor para crear una sesión de Checkout.

En tu servidor, crea una Checkout Session y redirige a tu cliente a la URL que se devuelve en la respuesta.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"="Restaurant delivery service" \
  -d "line_items[0][price_data][unit_amount]"=10000 \
  -d "line_items[0][quantity]"=1 \
  -d "payment_intent_data[transfer_group]"=ORDER100 \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success?session_id={CHECKOUT_SESSION_ID}"

Stripe envía un evento checkout.session.completed cuando se completa el pago. Utiliza un webhook para recibir estos eventos y ejecutar acciones, como enviar un correo electrónico de confirmación del pedido a tu cliente, registrar la venta en una base de datos o iniciar el flujo de tareas para un envío.

Presta atención a estos eventos en lugar de esperar una devolución de llamada del cliente. De su lado, el cliente puede cerrar la ventana del navegador o salir de la aplicación antes de que se ejecute la devolución de llamada. Algunos métodos de pago tardan entre 2 y 14 días en confirmar el pago. Si configuras tu integración para identificar eventos asincrónicos, podrás aceptar varios métodos de pago con una sola integración.

Administra los siguientes eventos al cobrar pagos con Checkout:

Todos estos eventos incluyen el objeto Checkout Session. Una vez que el pago se efectúa correctamente, el estado del PaymentIntent subyacente cambia de processing a succeeded o a un estado de falla.

En tu servidor, envía fondos desde tu cuenta a una cuenta conectada creando un envío de fondos y especificando el transfer_group utilizado.

curl https://api.stripe.com/v1/transfers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=7000 \
  -d currency=usd \
  -d destination=
"{{CONNECTED_ACCOUNT_ID}}" \
  -d transfer_group=ORDER100

Los importes de transferencia y cargo no tienen que coincidir. Puedes dividir un solo cargo entre varias transferencias o incluir varios cargos en una sola transferencia. En el siguiente ejemplo se crea una transferencia adicional asociada con el mismo transfer_group.

curl https://api.stripe.com/v1/transfers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=2000 \
  -d currency=usd \
  -d destination={{OTHER_CONNECTED_ACCOUNT_ID}} \
  -d transfer_group=ORDER100

Opciones de envíos de fondo

Puedes asignar cualquier valor a la cadena transfer_group, pero debes representar una sola acción comercial. También puedes realizar una transferencia sin un cargo asociado ni un transfer_group, por ejemplo, cuando debes pagar a un proveedor pero no hay un pago de cliente asociado.

De forma predeterminada, una solicitud de envío de fondos falla cuando el monto excede el saldo disponible de la cuenta de la plataforma Stripe no reintenta automáticamente las solicitudes de envío de fondos fallidas.

Puedes evitar que se produzcan errores en las solicitudes de envío de fondos asociados a cargos. Cuando especificas el cargo asociado como source_transaction del envío de fondos, la solicitud de envío de fondos se efectúa automáticamente. Sin embargo, no ejecutamos dicho envío hasta que los fondos de ese cargo estén disponibles en la cuenta de la plataforma.