Cómo crear facturas con Connect

Puedes crear facturas para cuentas conectadas que admitan varios métodos de cobro. Puedes usar cargos Direct para crearlos directamente en la cuenta conectada. Como opción, puedes crear facturas en la plataforma con envíos de fondos a la cuenta conectada usando cargos a un destino. También puedes retener una comisión de la aplicación en estas facturas.

Crear una factura usando cargos Direct

Para crear una factura que cobre directamente en una cuenta conectada, crea una factura mientras estás autenticado como la cuenta conectada. Para que funcione, el cliente tiene que estar definido en la cuenta conectada.

curl https://api.stripe.com/v1/invoices \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d customer=
{{CUSTOMER_ID}}
 \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
"

Al igual que cuando creas un cargo Direct en una cuenta conectada, puedes crear un cliente en una cuenta conectada usando la clave publicable de la plataforma o de la cuenta conectada. También puedes crear un token usando clientes compartidos. Si usas cargos Direct, la cuenta conectada es responsable del costo de las comisiones de Stripe, los rembolsos y los contracargos.

Crear una factura usando cargos a un Destino

Para generar una factura que cobre en la plataforma y cree envíos de fondos automáticos a una cuenta conectada, crea una factura y especifica el ID de la cuenta conectada como valor transfer_data[destination].

curl https://api.stripe.com/v1/invoices \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Para que funcione, el cliente debe estar definido en la cuenta de la plataforma, y tú debes crear el token de la cuenta conectada usando la clave publicable de la plataforma. Si se le cobra a un cliente, el cliente debe existir dentro de la cuenta de la plataforma. Si se usan envíos de fondos automáticos, la plataforma es la empresa de registro.

Muestra las ID fiscales y los datos de la empresa de las cuentas conectadas en tus facturas

Algunas regiones tienen requisitos normativos que obligan a los comerciantes a mostrar sus ID fiscales y otros datos de la empresa en los documentos orientados al cliente.

En algunos casos, puedes cumplir estos requisitos mostrando información sobre una cuenta conectada en lugar de información sobre tu plataforma. Los siguientes pasos muestran cómo representar la identificación fiscal y los detalles de la empresa de una cuenta conectada en correos electrónicos de facturas, facturas en PDF, páginas de facturas alojadas y recibos de facturas:

1. Crea identificaciones fiscales para tus cuentas conectadas.
2. Establece las identificaciones fiscales predeterminadas para tu cuenta conectada.
3. Especifica la cuenta conectada usando el parámetro on_behalf_of o como issuer en facturas, suscripciones y calendarios de suscripciones nuevos o existentes.

Crea identificaciones fiscales para tus cuentas conectadas

En el siguiente ejemplo se crea un solo número de identificación fiscal para la cuenta conectada. Stripe almacena la identificación fiscal en la cuenta conectada. Para crear identificaciones fiscales adicionales, llama al punto de conexión nuevamente.

curl https://api.stripe.com/v1/tax_ids \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d type=eu_vat \
  -d value=DE123456789

Establece identificaciones fiscales predeterminadas para tu cuenta conectada

Stripe obtiene automáticamente las identificaciones fiscales predeterminadas de la cuenta del issuer de la factura durante la finalización, a menos que account_tax_ids ya esté establecido en las facturas.

Puedes establecer las identificaciones fiscales almacenadas en la cuenta conectada como identificaciones fiscales predeterminadas para esa cuenta. En el siguiente ejemplo, se establecen las identificaciones fiscales existentes como identificaciones fiscales predeterminadas:

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "settings[invoices][default_account_tax_ids][0]"=atxi_123 \
  -d "settings[invoices][default_account_tax_ids][1]"=atxi_456

Establece al emisor en facturas, suscripciones y calendarios de suscripciones nuevos o existentes como la cuenta conectada

En el siguiente ejemplo se establece issuer en una suscripción existente. Durante la finalización de la factura de suscripción, las facturas de suscripción obtienen las identificaciones fiscales predeterminadas del emisor:

curl https://api.stripe.com/v1/subscriptions/
{{SUBSCRIPTION_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "invoice_settings[issuer][type]"=account \
  -d "invoice_settings[issuer][account]"=
{{CONNECTED_ACCOUNT_ID}}

En el siguiente ejemplo, se establece issuer durante la creación de la factura:

curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "issuer[type]"=account \
  -d "issuer[account]"=
{{CONNECTED_ACCOUNT_ID}} \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Alternativamente, el parámetro on_behalf_of también muestra los detalles de una cuenta conectada en el correo electrónico de la factura, la factura en PDF, la página de facturas alojadas y el recibo de la factura.

Define identificaciones fiscales de la cuenta en facturas, suscripciones y calendarios de suscripciones nuevos o existentes

Puedes especificar account_tax_ids para facturas, suscripciones y calendarios de suscripciones para reemplazar las identificaciones fiscales predeterminadas. En el siguiente ejemplo se establece account_tax_ids en una suscripción existente:

curl https://api.stripe.com/v1/subscriptions/
{{SUBSCRIPTION_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "invoice_settings[issuer][type]"=account \
  -d "invoice_settings[issuer][account]"=
{{CONNECTED_ACCOUNT_ID}} \
  -d "invoice_settings[account_tax_ids][0]"=txi_123 \
  -d "invoice_settings[account_tax_ids][1]"=txi_456

En el siguiente ejemplo se establece account_tax_ids durante la creación de la factura:

curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "issuer[type]"=account \
  -d "issuer[account]"=
{{CONNECTED_ACCOUNT_ID}} \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}} \
  -d "account_tax_ids[0]"=txi_123 \
  -d "account_tax_ids[1]"=txi_456

Crea identificaciones fiscales almacenadas en la plataforma para tu cuenta conectada

La identificación fiscal que crees se almacenará en la cuenta de la plataforma en lugar de en la cuenta conectada. En el siguiente ejemplo se crea un solo número de identificación fiscal para la cuenta conectada sin usar el encabezado Stripe-Account:

curl https://api.stripe.com/v1/tax_ids \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d type=eu_vat \
  -d value=DE123456789 \
  -d "owner[type]"=account \
  -d "owner[account]"=
{{CONNECTED_ACCOUNT_ID}}

Cobrar comisiones de la aplicación

En la factura, tienes la opción de retener una comisión de la aplicación. El siguiente ejemplo muestra un application_fee_amount para una factura con un cargo Direct en la cuenta conectada:

curl https://api.stripe.com/v1/invoices \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d application_fee_amount="10" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
"

Este ejemplo muestra un application_fee_amount para una factura con un cargo a un Destino:

curl https://api.stripe.com/v1/invoices \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d application_fee_amount="10" \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Determinar que la cuenta conectada sea el comerciante a cargo del cobro

Para que la cuenta conectada sea el comerciante a cargo del cobro, debes cobrarle al cliente usando el parámetro on_behalf_of al crear o actualizar la factura. Debes establecer on_behalf_of en la API antes de finalizar la factura. El Dashboard no cuenta con una interfaz para facturas enviadas en nombre de cuentas conectadas.

Al definir el parámetro on_behalf_of, la imagen de marca, la información de contacto y el número de identificación fiscal de la cuenta conectada se aplican al correo electrónico de la factura, a la factura en PDF, a la página de facturas alojadas y al recibo de la factura. Sin embargo, cuando usas on_behalf_of en un entorno de prueba, no se envían correos electrónicos, como ocurre con las facturas estándar enviadas con la API. Mientras haces la prueba en un entorno de prueba, puedes verificar que Stripe haya creado una factura consultando la página Facturas del Dashboard.

Para cobrar pagos en nombre de la cuenta conectada, la cuenta conectada también debe tener funcionalidades de cuenta habilitadas para los métodos de pago correspondientes. Puedes transferir automáticamente los pagos de facturas creadas en nombre de la cuenta conectada usando cargos a un destino. Para obtener más información acerca del parámetro on_behalf_of​, consulta la documentación pertinente de Connect:

• Para obtener información sobre envíos de fondos automáticos a la cuenta conectada, consulta la información relacionada con los parámetros on_behalf_of en la guía Crear un cargo.
• Para obtener información sobre cómo transferir pagos manualmente, consulta Disponibilidad de transferencias.
• Para obtener una lista de las funcionalidades de cuenta necesarias para cobrar pagos en nombre de la cuenta conectada, consulta Funcionalidades para métodos de pago.

El siguiente ejemplo muestra cómo utilizar el parámetro on_behalf_of para una factura nueva usando cargos y envíos de fondos separados:

curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d on_behalf_of=
{{CONNECTED_ACCOUNT_ID}} \
  -d customer=
{{CUSTOMER_ID}}

Como ocurre con los cargos a un Destino estándar, se puede definir un application_fee_amount en las facturas. Este ejemplo indica cómo usar on_behalf_of con cargos a un Destino y una comisión de la aplicación.

curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d on_behalf_of=
{{CONNECTED_ACCOUNT_ID}} \
  -d application_fee_amount=10 \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}} \
  -d customer=
{{CUSTOMER_ID}}

Las facturas creadas en nombre de una cuenta conectada no admiten métodos de pago mediante transferencia bancaria, como transferencias de crédito ACH y cheques impresos.

Integra el cálculo y cobro de impuestos

Primero debes determinar qué entidad es responsable del pago de impuestos. La entidad responsable de los impuestos puede ser tu cuenta conectada o la plataforma, en función de tu modelo de negocio. Para obtener más información, consulta Stripe Tax con Connect.