Ir a contenido
Crea una cuenta
o
inicia sesión
Logotipo de la documentación de Stripe
/
Pregúntale a la IA
Crear cuenta
Iniciar sesión
Empezar
Pagos
Automatización de finanzas
Plataformas y marketplaces
Gestión del dinero
Herramientas para desarrolladores
Empezar
Pagos
Automatización de finanzas
Empezar
Pagos
Automatización de finanzas
Plataformas y marketplaces
Gestión del dinero
ResumenExplora todos los productos
Start building
Empezar a desarrollar
Proyectos de muestra
Acerca de las API
    Visita a la API
    API Payment Intents
    API Setup Intents
    Métodos de pago
    Productos y precios
    API anteriores
      Cargos
        Migrar a las nuevas API
        Aceptar una tarjeta de pago
        Guardar una tarjeta
        Bloquear un importe en una tarjeta
        Charges con Connect
      Fuentes
    Fases de lanzamiento
Crear con LLM
Utiliza Stripe sin necesidad de programación
Configura Stripe
Crea una cuenta
Dashboard web
Dashboard móvil
Migrar a Stripe
Gestiona el riesgo de fraude
Comprender el fraude
Protección antifraude de Radar
Gestiona disputas
Verificar identidades
InicioEmpezarAbout the APIsOlder APIsCharges

Stripe Connect y la API Charges

Copia la página

API heredada

The content of this section refers to a Legacy feature. Use the Payment Intents API instead.

La API Charges no admite las siguientes funciones, muchas de las cuales son necesarias para cumplir con la normativa de las tarjetas de crédito:

  • Comerciantes de India
  • Bank requests for card authentication
  • Strong Customer Authentication

Descubre cómo Connect te permite realizar cargos y emitir envíos de fondos para cuentas conectadas. La forma en que configuras estas opciones determina tus comisiones de Stripe.

Connect admite tres enfoques para crear pagos en una cuenta conectada. Para obtener más información sobre los diferentes tipos de cargos con Connect, consulta la documentación sobre cómo elegir un enfoque. Las comisiones de Stripe se determinan según cómo configures estas opciones.

En esta página, solo se explica cómo hacer llamadas a la API Charges para cuentas conectadas. Consulta las páginas vinculadas para obtener más información sobre llamadas a otras API para operaciones relacionadas.

Cargos directos

Para crear un cargo directo en la cuenta conectada, crea un objeto Charge y añade el encabezado Stripe-Account con un valor del ID de la cuenta conectada:

Command Line
cURL
curl https://api.stripe.com/v1/charges \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -H "Stripe-Account:
{{CONNECTED_ACCOUNT_ID}}
"
\ -d amount=1000 \ -d currency=usd \ -d source=tok_visa

Este ejemplo usa un token de prueba, tok_visa, pero podrías tokenizar una tarjeta de prueba usando Stripe.js y Elements en su lugar.

Consulta Aceptar un pago para conocer más detalles.

Cobra las comisiones de la aplicación sobre cargos directos

Con Connect, tu plataforma puede cobrar una comisión de la aplicación sobre los cargos directos. Para fijar esta comisión, especifica un número entero positivo como valor opcional de application_fee_amount:

Command Line
cURL
curl https://api.stripe.com/v1/charges \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -H "Stripe-Account:
{{CONNECTED_ACCOUNT_ID}}
"
\ -d amount=1000 \ -d currency=usd \ -d source=tok_visa \ -d application_fee_amount=123

Consulta Cargos directos para obtener información sobre la disponibilidad de transferencias, reembolsos, etc.

Cargos indirectos

Para crear cargos indirectos, especifica el ID de la cuenta conectada en el atributo transfer_data[destination]:

Command Line
cURL
curl https://api.stripe.com/v1/charges \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d amount=1000 \ -d currency=usd \ -d source=tok_visa \ -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Este ejemplo usa un token de prueba, tok_visa, pero podrías tokenizar una tarjeta de prueba usando Stripe.js y Elements en su lugar.

Consulta Aceptar un pago para conocer más detalles.

Cobra comisiones sobre cargos indirectos con application_fee_amount

Cuando se crea un cargo indirecto con application_fee_amount, el importe total del cargo se transfiere de inmediato de la plataforma a la cuenta transfer_data[destination] después de la captura del cargo. El application_fee_amount (que no puede superar el importe total del cargo) se transfiere de nuevo a la plataforma.

Command Line
cURL
curl https://api.stripe.com/v1/charges \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d amount=1000 \ -d currency=usd \ -d source=tok_visa \ -d application_fee_amount=123 \ -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Para facilitar la elaboración de informes, se crea un objeto Application Fee después de cobrarse la comisión de la aplicación. Utiliza la propiedad amount en el objeto Application Fee para elaborar informes. También puedes acceder a estos objetos mediante el punto de conexión de comisiones de la aplicación.

Cobra comisiones sobre cargos indirectos con transfer_data[amount]

También puedes aceptar una comisión mediante transfer_data[amount].

transfer_data[amount] es un número entero positivo que refleja el importe del cargo que se transfiere a transfer_data[destination]. Resta las comisiones de tu plataforma al importe del cargo, y luego especifica el resultado del cálculo como transfer_data[amount]:

Command Line
cURL
curl https://api.stripe.com/v1/charges \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d amount=1000 \ -d currency=usd \ -d source=tok_visa \ -d "transfer_data[amount]"=877 \ -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Consulta Cargos indirectos para obtener información sobre la disponibilidad de transferencias, reembolsos, etc.

Cargos y envíos de fondos separados

Precaución

Solamente puedes utilizar cargos y envíos de fondos separados si tu plataforma y la cuenta conectada están en la misma región. Por ejemplo, si tu cuenta de plataforma está en Europa, la cuenta conectada también debe estar en Europa.

Para crear un cargo y configurar el envío de fondos asociado, crea un transfer_group y asigna el cargo al transfer_group.

Command Line
curl
# Create a Charge: curl https://api.stripe.com/v1/charges \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -d "amount"=10000 \ -d "currency"="usd" \ -d "source"="tok_visa" \ -d "transfer_group"="{ORDER10}"
Command Line
curl
# Create a Transfer to a connected account (later): curl https://api.stripe.com/v1/transfers \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -d "amount"=7000 \ -d "currency"="usd" \ -d "destination"="{{CONNECTED_STRIPE_ACCOUNT_ID}}" \ -d "transfer_group"="{ORDER10}"
Command Line
curl
# Create a second Transfer to another connected account (later): curl https://api.stripe.com/v1/transfers \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -d "amount"=2000 \ -d "currency"="usd" \ -d "destination"="{{OTHER_CONNECTED_STRIPE_ACCOUNT_ID}}" \ -d "transfer_group"="{ORDER10}"

Este ejemplo usa un token de prueba, tok_visa, pero podrías tokenizar una tarjeta de prueba usando Stripe.js y Elements en su lugar.

Consulta Aceptar un pago para obtener más información.

Cómo usar el argumento on_behalf_of con cargos y envíos de fondos separados

Con cargos y envíos de fondos separados, los valores predeterminados son:

  • Los cargos se cobran en el país de la plataforma
  • Se utiliza la estructura de comisiones del país de la plataforma
  • La información de la plataforma se muestra en el extracto de la tarjeta de crédito del cliente

Si prefieres usar el país de la cuenta conectada y mostrar su información, usa el argumento on_behalf_of.

Precaución

Solo puedes utilizar on_behalf_of con cargos y envíos de fondos separados para cuentas conectadas con la funcionalidad card_payments.

Command Line
cURL
curl https://api.stripe.com/v1/charges \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d amount=1000 \ -d currency=usd \ -d source=tok_visa \ -d on_behalf_of=
{{CONNECTED_ACCOUNT_ID}}

Consulta Cómo crear cargos y envíos de fondos separados para obtener información sobre la disponibilidad de los envíos de fondos, los reembolsos, etc.

¿Te ha sido útil la página?
SíNo
¿Necesitas ayuda? Ponte en contacto con el equipo de soporte.
Únete a nuestro programa de acceso anticipado.
Echa un vistazo a nuestro registro de cambios.
¿Tienes alguna pregunta? Ponte en contacto con el equipo de ventas.
¿LLM? Lee llms.txt.
Con tecnología de Markdoc