Crea cargos y envíos de fondos separados

Crea cargos y envíos de fondos separados para transferir fondos de un pago a varias cuentas conectadas, o cuando no se conozca a un usuario específico en el momento del pago. El cargo en la cuenta de tu plataforma se desasocia de las transferencias a tus cuentas conectadas. Con este tipo de cargo, puedes hacer lo siguiente:

• Creas un cargo en la cuenta de tu plataforma y también transfieres fondos a tus cuentas conectadas. El pago aparece como un cargo en tu cuenta y también hay transferencias a cuentas conectadas (por un importe determinado por ti), que se extraen del saldo de tu cuenta.
• Puedes transferir fondos a varias cuentas conectadas.
• Se debita del saldo de tu cuenta el costo de las comisiones, los reembolsos y los contracargos de Stripe.

Este tipo de cargo ayuda a los marketplaces a dividir los pagos entre varias partes, por ejemplo, una plataforma de entrega de restaurantes que divide los pagos entre el restaurante y el repartidor.

Stripe acepta cargos y transferencias separados en las siguientes regiones:

En la mayoría de los casos, tu plataforma y todas las cuentas conectadas deben ser de la misma región. Si intentas transferir fondos a través de una frontera no permitida, se producirá un error. Para obtener información sobre el soporte entre regiones, consulta transferencias transfronterizas. Debes usar los envíos de fondos únicamente en combinación con los casos de uso permitidos para cargos, recargas y comisiones. Recomendamos usar cargos y envíos de fondos separados para las cuentas conectadas que tienen acceso al Dashboard de Express o que no tienen acceso al Dashboard.

Integra la interfaz de usuario de pago prediseñada de Stripe a la confirmación de compra de tu aplicación Android con la clase PaymentSheet.

Configura Stripe

Lado del servidor

Lado del cliente

Primero, necesitas una cuenta de Stripe. Inscríbete ahora.

Lado del servidor

Esta integración necesita puntos de conexión en tu servidor que se comuniquen con la API de Stripe. Usa las bibliotecas oficiales para acceder a la API de Stripe desde tu servidor:

Command Line

Seleccionar un idioma

Ruby

Python

PHP

Java

Node.js

Go

.NET

No results

# Available as a gem
sudo gem install stripe

Gemfile

Seleccionar un idioma

Ruby

Python

PHP

Java

Node.js

Go

.NET

No results

# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Lado del cliente

El SDK para Android de Stripe es de código abierto y está completamente documentado.

Para instalar el SDK, agrega stripe-android al bloque dependencies de tu archivo app/build.gradle:

build.gradle.kts

Seleccionar un idioma

Kotlin

Groovy

No results

plugins {
    id("com.android.application")
}

android { ... }

dependencies {
  // ...

  // Stripe Android SDK
  implementation("com.stripe:stripe-android:21.26.1")
  // Include the financial connections SDK to support US bank account as a payment method
  implementation("com.stripe:financial-connections:21.26.1")
}

Nota

Para conocer detalles de la última versión y de versiones anteriores del SDK, consulta la página Versiones en GitHub. Para recibir una notificación cuando se publique una nueva versión, mira las versiones del repositorio.

Configura el SDK con tu clave publicable de Stripe para que pueda hacer solicitudes a la API de Stripe, así como en tu subclase Application:

Seleccionar un idioma

Kotlin

Java

No results

import com.stripe.android.PaymentConfiguration

class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()
        PaymentConfiguration.init(
            applicationContext,
            
"pk_test_TYooMQauvdEDq54NiTphI7jx"
        )
    }
}

Nota

Usa las claves de prueba durante las pruebas y el desarrollo, y tus claves para modo activo cuando publiques tu aplicación.

Agregar un punto de conexión

Lado del servidor

Esta integración usa tres objetos de la API de Stripe:

1. Un PaymentIntent. Stripe lo utiliza para representar tu intención de cobrarle a un cliente, haciendo el seguimiento de los intentos de cobro y de los cambios en el estado del pago a lo largo del proceso.
2. Un objeto Customer(opcional). Para configurar un método de pago para pagos futuros, tienes que asociarlo a un objeto Customer. Crea el “Customer Object” cuando tu cliente cree una cuenta en tu empresa. Si tu cliente hace un pago como invitado, puedes crear un “Customer Object” antes del pago y asociarlo con tu propia representación interna de la cuenta del cliente más adelante.
3. Una Ephemeral Key del objeto Customer (opcional). La información que contiene el “Customer Object” es confidencial y no se puede recuperar directamente desde una aplicación. La clave efímera le otorga al SDK acceso temporal al objeto Customer.

Si quieres guardar tarjetas y permitir que los clientes frecuentes vuelvan a utilizarlas, necesitas los objetos Customer y Customer Ephemeral Key para tu integración. De lo contrario, puedes omitir estos objetos.

Por motivos de seguridad, tu aplicación no puede crear estos objetos. En su lugar, agrega un punto de conexión en tu servidor que:

1. Recupera el objeto Customer o crea uno nuevo.
2. Crea una Ephemeral Key para el objeto Customer.
3. Crea un PaymentIntent con el importe, la moneda, el cliente y un grupo de transferencias para asociar con el envío de fondos más adelante.
4. Devuelve a tu aplicación el secreto de cliente del Payment Intent, el valor secret de la clave efímera, el ID del cliente y tu clave publicable.

Los métodos de pago que se muestran a los clientes durante el proceso de finalización de compra también se incluyen en el PaymentIntent. Puedes permitir que Stripe extraiga los métodos de pago de tu configuración del Dashboard o puedes enumerarlos manualmente.

A menos que tu integración requiera una opción basada en código para ofrecer métodos de pago, no los enumeres manualmente. Stripe evalúa la moneda, las restricciones de los métodos de pago y otros parámetros para determinar la lista de métodos de pago admitidos. Stripe prioriza los métodos de pago que aumentan la conversión y guardan mayor relación con la moneda y ubicación del cliente. Ocultamos los métodos de pago de prioridad más baja en un menú de contenido adicional.

Gestionar los métodos de pago desde el Dashboard

Cómo enumerar métodos de pago manualmente

Puedes bifurcar y ejecutar una implementación de este punto de conexión en CodeSandbox para realizar pruebas.

Command Line

Seleccionar un idioma

curl

Ruby

Python

PHP

Java

Node.js

Ir

.NET

No results

# Create a Customer (use an existing Customer ID if this is a returning customer)
curl https://api.stripe.com/v1/customers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -X "POST"

# Create an Ephemeral Key for the Customer
curl https://api.stripe.com/v1/ephemeral_keys \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -H "Stripe-Version: 2025-08-27.basil" \
  -X "POST" \
  -d "customer"=
{{CUSTOMER_ID}} \

# Create a PaymentIntent
curl https://api.stripe.com/v1/payment_intents \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -X "POST" \
  -d "customer"=
{{CUSTOMER_ID}} \
  -d "amount"=10000 \
  -d "currency"="usd" \
  # In the latest version of the API, specifying the `automatic_payment_methods` parameter
  # is optional because Stripe enables its functionality by default.
  -d "automatic_payment_methods[enabled]"=true \
  -d transfer_group="ORDER100" \

Integrar la hoja de pago

Lado del cliente

Antes de mostrar el Payment Element móvil, tu página de finalización de compra debe cumplir con los siguientes requisitos:

• Mostrar los productos de la compra y el importe total
• Recopilar cualquier dato de envío requerido usando el Address Element
• Incluye un botón de confirmación de compra para presentar la interfaz de usuario de Stripe

Jetpack Compose

Vistas (clásicas)

Inicializa una instancia de PaymentSheet dentro de onCreate de tu actividad de finalización de compra, especificando un método para administrar el resultado.

import androidx.compose.runtime.Composable
import androidx.compose.runtime.remember
import com.stripe.android.paymentsheet.PaymentSheet
import com.stripe.android.paymentsheet.PaymentSheetResult

@Composable
fun App() {
  val paymentSheet = remember { PaymentSheet.Builder(::onPaymentSheetResult) }.build()
}

private fun onPaymentSheetResult(paymentSheetResult: PaymentSheetResult) {
  // implemented in the next steps
}

A continuación, captura el secreto de cliente del PaymentIntent, el secreto de la clave efímera, el ID del cliente y la clave publicable del punto de conexión que creaste en el paso anterior. Define tu clave publicable usando PaymentConfiguration y guarda las otras para usarlas cuando presentes la PaymentSheet.

import androidx.compose.runtime.Composable
import androidx.compose.runtime.remember
import androidx.compose.runtime.LaunchedEffect
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.setValue
import androidx.compose.ui.platform.LocalContext
import com.stripe.android.PaymentConfiguration
import com.stripe.android.paymentsheet.PaymentSheet
import com.stripe.android.paymentsheet.PaymentSheetResult

@Composable
fun App() {
  val paymentSheet = remember { PaymentSheet.Builder(::onPaymentSheetResult) }.build()
  val context = LocalContext.current
  var customerConfig by remember { mutableStateOf<PaymentSheet.CustomerConfiguration?>(null) }
  var paymentIntentClientSecret by remember { mutableStateOf<String?>(null) }

  LaunchedEffect(context) {
    // Make a request to your own server and retrieve payment configurations
    val networkResult = ...
    if (networkResult.isSuccess) {
        paymentIntentClientSecret = networkResult.paymentIntent
        customerConfig = PaymentSheet.CustomerConfiguration(
          id = networkResult.customer,
          ephemeralKeySecret = networkResult.ephemeralKey
        )
        PaymentConfiguration.init(context, networkResult.publishableKey)
    }
  }
}

private fun onPaymentSheetResult(paymentSheetResult: PaymentSheetResult) {
  // implemented in the next steps
}

Cuando el cliente toca tu botón de confirmación de compra, llama a presentWithPaymentIntent para presentar la hoja de pago. Una vez que el cliente completa el pago, la hoja se cierra y se llama al PaymentSheetResultCallback con un PaymentSheetResult.

import androidx.compose.material.Button
import androidx.compose.material.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.LaunchedEffect
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.setValue
import androidx.compose.ui.platform.LocalContext
import com.stripe.android.PaymentConfiguration
import com.stripe.android.paymentsheet.PaymentSheet
import com.stripe.android.paymentsheet.PaymentSheetResult

@OptIn(ExperimentalCustomerSessionApi::class)
@Composable
fun App() {
  val paymentSheet = remember { PaymentSheet.Builder(::onPaymentSheetResult) }.build()
  val context = LocalContext.current
  var customerConfig by remember { mutableStateOf<PaymentSheet.CustomerConfiguration?>(null) }
  var paymentIntentClientSecret by remember { mutableStateOf<String?>(null) }

  LaunchedEffect(context) {
    // Make a request to your own server and retrieve payment configurations
    val networkResult = ...
    if (networkResult.isSuccess) {
        paymentIntentClientSecret = networkResult.paymentIntent
        customerConfig = PaymentSheet.CustomerConfiguration(
          id = networkResult.customer,
          ephemeralKeySecret = networkResult.ephemeralKey
        )
        PaymentConfiguration.init(context, networkResult.publishableKey)
    }
  }

  Button(
    onClick = {
      val currentConfig = customerConfig
      val currentClientSecret = paymentIntentClientSecret

      if (currentConfig != null && currentClientSecret != null) {
        presentPaymentSheet(paymentSheet, currentConfig, currentClientSecret)
      }
    }
  ) {
    Text("Checkout")
  }
}

private fun presentPaymentSheet(
  paymentSheet: PaymentSheet,
  customerConfig: PaymentSheet.CustomerConfiguration,
  paymentIntentClientSecret: String
) {
  paymentSheet.presentWithPaymentIntent(
    paymentIntentClientSecret,
    PaymentSheet.Configuration.Builder(merchantDisplayName = "My merchant name")
      .customer(customerConfig)
      // Set `allowsDelayedPaymentMethods` to true if your business handles
      // delayed notification payment methods like US bank accounts.
      .allowsDelayedPaymentMethods(true)
      .build()
  )
}

private fun onPaymentSheetResult(paymentSheetResult: PaymentSheetResult) {
  when(paymentSheetResult) {
    is PaymentSheetResult.Canceled -> {
      print("Canceled")
    }
    is PaymentSheetResult.Failed -> {
      print("Error: ${paymentSheetResult.error}")
    }
    is PaymentSheetResult.Completed -> {
      // Display for example, an order confirmation screen
      print("Completed")
    }
  }
}

Establecer allowsDelayedPaymentMethods en true permite aceptar métodos de pago de notificación diferida como cuentas bancarias en EE. UU. Para estos métodos de pago, el estado final del pago no se conoce cuando se completa el PaymentSheet, sino que se efectúa con éxito o falla más tarde. Si aceptas este tipo de métodos de pago, infórmale al cliente que su pedido está confirmado y solo finalízalo (por ejemplo, envía el producto) cuando el pago se realice correctamente.

Administrar eventos posteriores al pago

Lado del servidor

Stripe envía un evento payment_intent.succeeded cuando se completa el pago. Usa la herramienta de webhook del Dashboard o sigue la guía de webhooks para recibir estos eventos y ejecutar acciones como, por ejemplo, enviar un correo electrónico de confirmación del pedido a tu cliente, registrar la venta en una base de datos o iniciar un flujo de envío.

Escucha 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, y clientes malintencionados podrían manipular la respuesta. Si configuras tu integración para escuchar eventos asincrónicos, podrás aceptar diferentes tipos de métodos de pago con una sola integración.

Además de administrar el evento payment_intent.succeeded, recomendamos administrar estos otros eventos si se cobran pagos con el Payment Element:

Evento	Descripción	Acción
payment_intent.succeeded	Se envía cuando un cliente completa correctamente un pago.	Envía al cliente una confirmación del pedido y completa el pedido.
payment_intent.processing	Se envía cuando un cliente inicia con éxito un pago, pero éste aún no se completó. Este evento se envía normalmente cuando el cliente inicia un débito bancario. Le sigue un evento payment_intent.succeeded o payment_intent.payment_failed en el futuro.	Envía al cliente una confirmación del pedido que indique que el pago está pendiente. En caso de productos digitales, quizá te convenga completar el pedido antes de esperar que se complete el pago.
payment_intent.payment_failed	Enviado cuando un cliente intenta un pago, pero el pago falla.	Si un pago pasa de processing a payment_failed, ofrécele al cliente otro intento de pago.

Crear un envío de fondos

Lado del servidor

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.

Command Line

Seleccionar un idioma

cURL

Stripe CLI

Ruby

Python

PHP

Java

Node.js

Go

.NET

No results

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.

Command Line

Seleccionar un idioma

cURL

Stripe CLI

Ruby

Python

PHP

Java

Node.js

Go

.NET

No results

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.

Nota

El transfer_group solo identifica los objetos asociados. No afecta a ninguna funcionalidad estándar. Para evitar que se ejecute una transferencia antes de que estén disponibles los fondos del cargo asociado, usa el atributo source_transaction de la transferencia.

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.

Nota

Si utilizas cargos y envíos de fondos separados, tenlo en cuenta al planificar tu calendario de transferencias. Las transferencias automáticas pueden interferir con las transferencias que no tienen una source_transaction definida.

Probar la integración

Tarjetas

Redireccionamientos bancarios

Débitos bancarios

Número de tarjeta	Escenario	Cómo hacer la prueba
4242424242424242	El pago con tarjeta se efectúa correctamente y no requiere autenticación.	Completa el formulario de tarjeta de crédito con el número de tarjeta de crédito y la fecha de vencimiento, el CVC o el código postal.
4000002500003155	El pago con tarjeta requiere autenticación.	Completa el formulario de tarjeta de crédito con el número de tarjeta de crédito y la fecha de vencimiento, el CVC o el código postal.
4000000000009995	La tarjeta es rechazada con un código de rechazo insufficient_funds.	Completa el formulario de tarjeta de crédito con el número de tarjeta de crédito y la fecha de vencimiento, el CVC o el código postal.
6205500000000000004	La tarjeta UnionPay puede tener entre 13 y 19 dígitos.	Completa el formulario de tarjeta de crédito con el número de tarjeta de crédito y la fecha de vencimiento, el CVC o el código postal.

Consulta Pruebas para obtener información adicional para probar tu integración.

OpcionalActivar Google Pay

Configura tu integración

Para usar Google Pay, primero habilita la API de Google Pay agregando lo siguiente a la etiqueta <application> de tu AndroidManifest.xml:

AndroidManifest.xml

<application>
  ...
  <meta-data
    android:name="com.google.android.gms.wallet.api.enabled"
    android:value="true" />
</application>

Para obtener más detalles, consulta cómo configurar la API de Google Pay para Android en Google Pay.

Agregar Google Pay

Para agregar Google Pay a tu integración, especifica un PaymentSheet.GooglePayConfiguration con tu entorno de Google Pay (de producción o de prueba) y el código de país de tu empresa al inicializar PaymentSheet.Configuration.

Seleccionar un idioma

Kotlin

Java

No results

val googlePayConfiguration = PaymentSheet.GooglePayConfiguration(
  environment = PaymentSheet.GooglePayConfiguration.Environment.Test,
  countryCode = "US",
  currencyCode = "USD" // Required for Setup Intents, optional for Payment Intents
)
val configuration = PaymentSheet.Configuration.Builder(merchantDisplayName = "My merchant name")
  .googlePay(googlePayConfiguration)
  .build()

Prueba Google Pay

Google te permite realizar pagos de prueba a través de su paquete de tarjetas de prueba. El conjunto de pruebas admite el uso de tarjetas de prueba de Stripe.

Puedes probar Google Pay con un dispositivo Android físico. Asegúrate de tener un dispositivo en un país en que admita Google Pay e inicia sesión en una cuenta de Google en tu dispositivo de prueba con una tarjeta real guardada en Google Wallet.

OpcionalPersonalizar la hoja

Todo lo que se quiera personalizar se configura usando el objeto PaymentSheet.Configuration.

Appearance

Personaliza los colores y las fuentes, entre otros elementos, para que combinen con tu aplicación usando la API Appearance.

Diseño del método de pago

Configura el diseño de los métodos de pago en la hoja con paymentMethodLayout. Puedes mostrarlos horizontalmente, verticalmente o dejar que Stripe optimice el diseño de manera automática.

Seleccionar un idioma

Kotlin

Java

No results

PaymentSheet.Configuration.Builder("Example, Inc.")
  .paymentMethodLayout(PaymentSheet.PaymentMethodLayout.Automatic)
  .build()

Recopilar las direcciones de los usuarios

Recopila las direcciones de envío o facturación locales e internacionales de tus clientes usando el Address Element.

Nombre con el que aparecerá la empresa

Especifica el nombre que quieres que el cliente vea para tu empresa configurando merchantDisplayName. De manera predeterminada, este es el nombre de tu aplicación.

Seleccionar un idioma

Kotlin

Java

No results

PaymentSheet.Configuration.Builder(
  merchantDisplayName = "My app, Inc."
).build()

Modo oscuro

De forma predeterminada, PaymentSheet se adapta automáticamente a la configuración de aspecto de todo el sistema del usuario (modo claro y modo oscuro). Puedes cambiarla definiendo modo claro o modo oscuro en tu aplicación:

Seleccionar un idioma

Kotlin

Java

No results

// force dark
AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_YES)
// force light
AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_NO)

Datos de facturación predeterminados

Para establecer los valores predeterminados para los datos de facturación recopilados en la hoja de pago, configura la propiedad defaultBillingDetails. Los campos de la PaymentSheet se rellenan automáticamente con los valores que proporcionas.

Seleccionar un idioma

Kotlin

Java

No results

val address = PaymentSheet.Address(country = "US")
val billingDetails = PaymentSheet.BillingDetails(
  address = address,
  email = "foo@bar.com"
)
val configuration = PaymentSheet.Configuration.Builder(merchantDisplayName = "Merchant, Inc.")
  .defaultBillingDetails(billingDetails)
  .build()

Configura la recopilación de datos de facturación

Usa BillingDetailsCollectionConfiguration para especificar cómo deseas recopilar los datos de facturación en la PaymentSheet.

Puedes recopilar el nombre, el correo electrónico, el número de teléfono y la dirección del cliente.

Si quieres adjuntar datos de facturación predeterminados al objeto PaymentMethod aun cuando esos campos no se hayan recopilado en la interfaz de usuario, establece billingDetailsCollectionConfiguration.attachDefaultsToPaymentMethod en true.

Seleccionar un idioma

Kotlin

Java

No results

val billingDetails = PaymentSheet.BillingDetails(
  email = "foo@bar.com"
)
val billingDetailsCollectionConfiguration = BillingDetailsCollectionConfiguration(
  attachDefaultsToPaymentMethod = true,
  name = BillingDetailsCollectionConfiguration.CollectionMode.Always,
  email = BillingDetailsCollectionConfiguration.CollectionMode.Never,
  address = BillingDetailsCollectionConfiguration.AddressCollectionMode.Full,
)
val configuration = PaymentSheet.Configuration.Builder(merchantDisplayName = "Merchant, Inc.")
  .defaultBillingDetails(billingDetails)
  .billingDetailsCollectionConfiguration(billingDetailsCollectionConfiguration)
  .build()

Nota

Pregúntale a tu asesor legal sobre las leyes que se aplican a la recopilación de información. Solicita los números de teléfono solo si los necesitas para la transacción.

OpcionalCompleta el pago en tu interfaz de usuario

Puedes presentar una hoja de pago para recopilar solo los datos del método de pago y completar el pago en la interfaz de usuario de tu aplicación. Esto resulta útil si tienes un botón de compra personalizado o solicitas pasos adicionales después de recopilar los datos del pago.

Nota

A sample integration is available on our GitHub.

1. Primero, inicializa PaymentSheet.FlowController en lugar de PaymentSheet usando uno de los métodos Builder.

Seleccionar un idioma

Android (Kotlin)

Android (Java)

No results

class CheckoutActivity : AppCompatActivity() {
  private lateinit var flowController: PaymentSheet.FlowController

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    flowController = PaymentSheet.FlowController.Builder(
      paymentResultCallback = ::onPaymentSheetResult,
      paymentOptionCallback = ::onPaymentOption,
    ).build(this)
  }
}

1. A continuación, llama a configureWithPaymentIntent con las claves de objeto de Stripe recuperadas del backend y actualiza tu interfaz de usuario en la devolución de llamada usando getPaymentOption(). Contiene una imagen y una etiqueta que representan el método de pago seleccionado actualmente por el cliente.

Seleccionar un idioma

Android (Kotlin)

Android (Java)

No results

flowController.configureWithPaymentIntent(
  paymentIntentClientSecret = paymentIntentClientSecret,
  configuration = PaymentSheet.Configuration.Builder("Example, Inc.")
    .customer(PaymentSheet.CustomerConfiguration(
      id = customerId,
      ephemeralKeySecret = ephemeralKeySecret
    ))
    .build()
) { isReady, error ->
  if (isReady) {
    // Update your UI using `flowController.getPaymentOption()`
  } else {
    // handle FlowController configuration failure
  }
}

1. A continuación, llama a presentPaymentOptions para recopilar los datos del pago. Cuando el cliente termina, la hoja se cierra y llama al paymentResultCallback especificado anteriormente en create. Implementa este método para actualizar tu interfaz de usuario con la paymentOption devuelta.

Seleccionar un idioma

Android (Kotlin)

Android (Java)

No results

// ...
  flowController.presentPaymentOptions()
// ...
  private fun onPaymentOption(paymentOption: PaymentOption?) {
    if (paymentOption != null) {
      paymentMethodButton.text = paymentOption.label
      paymentMethodButton.setCompoundDrawablesRelativeWithIntrinsicBounds(
        paymentOption.drawableResourceId,
        0,
        0,
        0
      )
    } else {
      paymentMethodButton.text = "Select"
      paymentMethodButton.setCompoundDrawablesRelativeWithIntrinsicBounds(
        null,
        null,
        null,
        null
      )
    }
  }

1. Finalmente, llama a confirm para completar el pago. Cuando el cliente termina, la hoja se cierra y llama al paymentResultCallback especificado anteriormente en create.

Seleccionar un idioma

Android (Kotlin)

Android (Java)

No results

// ...
    flowController.confirmPayment()
  // ...

  private fun onPaymentSheetResult(
    paymentSheetResult: PaymentSheetResult
  ) {
    when (paymentSheetResult) {
      is PaymentSheetResult.Canceled -> {
        // Payment canceled
      }
      is PaymentSheetResult.Failed -> {
        // Payment Failed. See logcat for details or inspect paymentSheetResult.error
      }
      is PaymentSheetResult.Completed -> {
        // Payment Complete
      }
    }
  }

Establecer allowsDelayedPaymentMethods en true permite aceptar métodos de pago de notificación diferida como cuentas bancarias en EE. UU. Para estos métodos de pago, el estado final del pago no se conoce cuando se completa el PaymentSheet, sino que se efectúa con éxito o falla más tarde. Si aceptas este tipo de métodos de pago, infórmale al cliente que su pedido está confirmado y solo finalízalo (por ejemplo, envía el producto) cuando el pago se realice correctamente.

OpcionalHabilita métodos de pago adicionales

Ve a Administrar métodos de pago para cuentas conectadas en el Dashboard para configurar qué métodos de pago aceptan tus cuentas conectadas. Los cambios en la configuración predeterminada se aplican a todas las cuentas conectadas nuevas y existentes.

Consulta los siguientes recursos para obtener información sobre los métodos de pago:

• Guía de métodos de pago para ayudarte a elegir los métodos de pago correctos para tu plataforma.
• Funcionalidades de cuenta para asegurarte de que los métodos de pago que elegiste funcionen en tus cuentas conectadas.
• Consulta las tablas de admisibilidad de métodos de pago y de productos para asegurarte de que los métodos de pago elegidos funcionen para tus productos y flujos de pago de Stripe.

Para cada método de pago, puedes seleccionar una de las siguientes opciones desplegables:

Activado de manera predeterminada	Tus cuentas conectadas aceptan este método de pago durante el proceso de compra. Algunos métodos de pago solo pueden estar desactivados o bloqueados. Esto se debe a que tus cuentas conectadas con acceso al Dashboard de Stripe deben activarlas en su página de configuración.
Desactivado de manera predeterminada	Tus cuentas conectadas no aceptan este método de pago durante el proceso de compra. Si permites que tus cuentas conectadas con acceso al Dashboard de Stripe administren sus propios métodos de pago, podrán activarlo.
Bloqueado	Tus cuentas conectadas no aceptan este método de pago durante el proceso de compra. Si permites que tus cuentas conectadas con acceso al Dashboard de Stripe administren sus propios métodos de pago, no tendrán la opción para activarlo.

Opciones de métodos de pago

Si realizas un cambio en un método de pago, debes hacer clic en Revisar cambios en la barra inferior de la pantalla y en Guardar y aplicar para actualizar tus cuentas conectadas.

Cuadro de diálogo Guardar

Permite que las cuentas conectadas gestionen los métodos de pago

Stripe recomienda permitir que tus cuentas conectadas personalicen sus propios métodos de pago. Esta opción le permite a cada cuenta conectada con acceso al Dashboard de Stripe ver y actualizar página Métodos de pago. Solo los propietarios de las cuentas conectadas pueden personalizar sus métodos de pago. El Dashboard de Stripe muestra el conjunto de métodos de pago predeterminados que aplicaste a todas las cuentas conectadas nuevas y existentes. Tus cuentas conectadas pueden anular estos valores predeterminados, excluyendo los métodos de pago que hayas bloqueado.

Marca la casilla de verificación Personalización de la cuenta para habilitar esta opción. Debes hacer clic en Revisar cambios en la barra inferior de la pantalla y luego seleccionar Guardar y aplicar para actualizar esta configuración.

Casilla de verificación de personalización de la cuenta

Capacidades de métodos de pago

Para permitir que tus cuentas conectadas acepten métodos de pago adicionales, debes asegurarte de que sus cuentas conectadas tengan funcionalidades activas para cada método de pago. La mayoría de los métodos de pago tienen los mismos requisitos de verificación que la funcionalidad card_payments, con algunas restricciones y excepciones. La tabla de funcionalidades de métodos de pago enumera los métodos de pago que requieren verificación adicional de las tarjetas.

Dashboard

API

Ve a Configuración de pago de cuentas conectadas en el Dashboard para solicitar capacidades en tus cuentas conectadas nuevas y existentes para cada combinación de método de pago y país.

Especifica el comerciante a cargo del cobro

El comerciante a cargo del cobro depende de las funcionalidades activas en una cuenta y de cómo se crea el cargo. El comerciante a cargo del cobro determina de quién es la información utilizada para efectuar el cargo. Esto incluye la descripción del cargo (ya sea de la plataforma o de la cuenta conectada) que aparecerá para ese cargo en el extracto bancario o de tarjeta de crédito del cliente.

Si especificas el comerciante a cargo del cobro, puedes ser más explícito sobre quién es el destinatario del cargo. Por ejemplo, algunas plataformas prefieren ser el comerciante a cargo del cobro porque el usuario final interactúa directamente con ellas, como es el caso de las plataformas on-demand. No obstante, algunas plataformas tienen cuentas conectadas que interactúan directamente con los consumidores finales (por ejemplo, las tiendas físicas de una plataforma de e-commerce). En estos casos, es más lógico que el comerciante a cargo del cobro sea la cuenta conectada.

Puedes establecer el parámetro on_behalf_of en el ID de una cuenta conectada para que esa cuenta sea el comerciante a cargo del cobro. Cuando se usa on_behalf_of:

• Los cargos se liquidan en el país y la moneda de cobro de la cuenta conectada.
• Se utiliza la estructura de comisiones del país de la cuenta conectada.
• La descripción del cargo en el extracto bancario de la cuenta conectada se muestra en el extracto de la tarjeta de crédito del cliente.
• Si la cuenta conectada está en un país diferente al de la plataforma, la dirección y el número de teléfono de la cuenta conectada se muestran en el extracto de la tarjeta de crédito del cliente.
• La cantidad de días durante la que se retiene el saldo pendiente antes de pagar depende de la configuración del delay_days en la cuenta conectada.

Si se omite on_behalf_of, la plataforma es la empresa registrada para el pago.

Precaución

El parámetro on_behalf_of solo se admite para cuentas conectadas con una funcionalidad de pagos como card_payments. Las cuentas regidas por el Contrato de servicios del destinatario no pueden solicitar card_payments u otras funcionalidades de pago.

Command Line

Seleccionar un idioma

cURL

Stripe CLI

Ruby

Python

PHP

Java

Node.js

Go

.NET

No results

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=10000 \
  -d currency=usd \
  -d "automatic_payment_methods[enabled]"=true \
  -d on_behalf_of=
{{CONNECTED_ACCOUNT_ID}} \
  -d transfer_group=ORDER100

Cobra comisiones

Cuando se utilizan cargos y transferencias separados, la plataforma puede cobrar comisiones sobre un cargo al reducir la cantidad que transfiere a las cuentas de destino. Por ejemplo, considera una transacción de servicio de entrega a domicilio en un restaurante que implique pagos al restaurante y al socio de la App:

1. El cliente paga un cargo de 100 USD.
2. Stripe cobra una comisión de 3.20 USD y agrega los 96.80 USD restantes al saldo pendiente de la cuenta de la plataforma.
3. La plataforma transfiere 70 USD a la cuenta conectada del restaurante y 20 USD a la cuenta conectada del conductor.
4. Una comisión de plataforma de 6.80 USD permanece en la cuenta de la plataforma.

Para obtener información sobre cómo procesar pagos en múltiples monedas con Connect, consulta cómo trabajar con múltiples monedas.

Disponibilidad de los envíos de fondos

El comportamiento predeterminado es transferir fondos desde el saldo disponible de la cuenta de la plataforma. Si intentas transferir un monto que exceda el saldo disponible, falla y aparece un mensaje de error. Para evitar este problema, al crear una transferencia, vincula la partida a un cargo existente especificando el ID del cargo como parámetro source_transaction. Con un source_transaction, la solicitud de transferencia devuelve el saldo correcto independientemente de tu saldo disponible si el cargo relacionado aún no se ha acreditado. Sin embargo, los fondos no estarán disponibles en la cuenta de destino hasta que los fondos del cargo asociado estén disponibles para transferirlos desde la cuenta de la plataforma.

Si el cargo de origen tiene un valor transfer_group, Stripe asigna el mismo valor al transfer_group de la transferencia. De no ser así, Stripe genera una cadena con el formato group_ más el ID del PaymentIntent asociado, por ejemplo: group_pi_2NHDDD589O8KAxCG0179Du2s. Asigna esa cadena como el transfer_group tanto para el cargo como para la transferencia.

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

Puedes obtener la identificación del cargo del PaymentIntent:

• Obtén el atributo latest_charge del PaymentIntent. Este atributo es el ID del cargo más reciente asociado al PaymentIntent.
• Solicita una lista de cargos, donde se especifique el payment_intent en la solicitud. Este método devuelve los datos completos de todos los cargos asociados con el PaymentIntent.

Cuando se usa este parámetro:

• El importe del envío de fondos no debe superar el importe del cargo de origen
• Puedes crear varios envíos de fondos con la misma source_transaction siempre que la suma de los envíos no supere el cargo de origen
• El envío de fondos asume el estado pendiente del cargo asociado, es decir, si los fondos del cargo están disponibles en N días, el pago recibido a través del envío de fondos por la cuenta de Stripe de destino también estará disponible en N días.
• Stripe crea automáticamente un transfer_group para ti
• La moneda de la transacción de saldo asociada con el cargo debe coincidir con la moneda de la transferencia

Los métodos de pago asincrónicos, como ACH, pueden fallar después de realizar una solicitud de envío de fondos posterior. Para estos pagos, evita usar source_transaction. En su lugar, espera a que se active un evento charge.succeeded antes de transferir los fondos. Si tienes que usar source_transaction con estos pagos, debes implementar una funcionalidad para gestionar los errores de pagos.

Cuando falla un pago utilizado como source_transaction, se transfieren fondos del saldo de la cuenta de tu plataforma a la cuenta conectada para cubrir el pago. Para recuperar estos fondos, revierte la transferencia asociada con el source_transaction fallido.

Emite reembolsos

Puedes reembolsar cargos creados en tu plataforma usando su clave secreta. Sin embargo, el reembolso de un cargo no influye en ningún envío de fondos asociado. Tu plataforma es la que debe conciliar los importes adeudados reduciendo los importes de los envíos de fondos posteriores o revirtiendo los envíos de fondos.

curl https://api.stripe.com/v1/refunds \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d charge=
{{CHARGE_ID}}

Revertir envíos de fondos

Connect admite la posibilidad de revertir transferencias efectuadas a cuentas conectadas, ya sea en parte o en su totalidad (estableciendo un valor para amount). Usa las revocaciones de envíos de fondos solo para reembolsos o disputas relacionadas con el cargo, o para corregir errores en el envío de fondos.

curl https://api.stripe.com/v1/transfers/
{{TRANSFER_ID}}
/reversals \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=7000

Las revocaciones de envíos de fondos agregan el importe especificado (o el total) nuevamente al saldo de la plataforma, reduciendo el saldo disponible de la cuenta conectada según corresponda. Un envío de fondos se puede revertir solo si el saldo disponible de la cuenta conectada es mayor que el importe de la revocación o si tiene reservas conectadas habilitadas.

Si la revocación de la transferencia requiere una conversión de monedas y el monto revocado resultaría en un saldo de cero después de la conversión, se arrojará un error.

Deshabilitar los reembolsos de una cuenta conectada no bloqueará la capacidad de procesar anulaciones de transferencias.