Crea cargos a un destino

Crea cargos a un destino cuando los clientes hacen la transacción con tu plataforma por productos o servicios suministrados por tus cuentas conectadas y transfieres fondos inmediatamente a tus cuentas conectadas. Con este tipo de cargo:

• Creas un cargo en la cuenta de tu plataforma.
• Determinas si el total o una parte de los fondos se transfiere a la cuenta conectada.
• Se debita del saldo de tu cuenta el costo de las comisiones, los reembolsos y los contracargos de Stripe.

Este tipo de cargo es más óptimo para plataformas como Airbnb, una plataforma de alquiler de alojamientos o Lyft, una aplicación de viajes compartidos.

Con ciertas excepciones, si tu plataforma y una cuenta conectada no están en la misma región, debes especificar la cuenta conectada como el comerciante a cargo del cobro utilizando el parámetro on_behalf_of en el Payment Intent.

Recomendamos usar cargos a un destino para las cuentas conectadas que no tienen acceso al Dashboard completo de Stripe.

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:22.4.0")
  // Include the financial connections SDK to support US bank account as a payment method
  implementation("com.stripe:financial-connections:22.4.0")
}

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

Nota

Para mostrar la PaymentSheet antes de crear un PaymentIntent, consulta Recopila datos de pago antes de crear un Intent.

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

1. 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. (Opcional) Cliente: Para configurar un método de pago para pagos futuros, debes adjuntarlo a un Cliente. 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. (Opcional) CustomerSession: La información que contiene el “Customer Object” es confidencial y no se puede recuperar directamente desde una aplicación. Una CustomerSession otorga al SDK acceso temporal al objeto Customer y proporciona más opciones de configuración. Consulta una lista completa de opciones de configuración.

Nota

Si nunca guardas tarjetas para un cliente y no permites que los clientes frecuentes vuelvan a usar tarjetas guardadas, puedes omitir los objetos Customer y CustomerSession en tu integración.

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 haga lo siguiente:

1. Recupere el objeto Customer o cree uno nuevo.
2. Crea una CustomerSession para el cliente.
3. Crea un PaymentIntent con el importe, la moneda y el cliente.
4. Devuelve a tu aplicación el secreto de cliente del Payment Intent, el client_secret de CustomerSession, la ID del cliente y tu clave publicable.

Los métodos de pago que se muestran a los clientes durante el proceso 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. Independientemente de la opción que elijas, debes saber que la moneda especificada en el PaymentIntent filtra los métodos de pago que se muestran al cliente. Por ejemplo, si especificas eur en el PaymentIntent y tienes habilitado OXXO en el Dashboard, OXXO no se mostrará al cliente porque OXXO no admite pagos en eur.

A menos que tu integración requiera una opción basada en código para ofrecer métodos de pago, Stripe recomienda usar la opción automatizada. Esto se debe a que 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. Se les da prioridad a los métodos de pago que aumentan la conversión y guardan mayor relación con la moneda y la ubicación del cliente.

Gestionar los métodos de pago desde el Dashboard

Cómo enumerar métodos de pago manualmente

Puedes administrar los métodos de pago desde el Dashboard. Stripe maneja la devolución de métodos de pago elegibles según factores como el monto de la transacción, la moneda y el flujo de pago. El PaymentIntent se crea según los métodos de pago que configuraste en el Dashboard. Si no quieres usar el Dashboard o si quieres especificar métodos de pago manualmente, puedes enumerarlos usando el atributo payment_method_types.

Command Line

Seleccionar un idioma

curl

Ruby

Python

PHP

Java

Node.js

Go

.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" \
  -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}"

# Create an CustomerSession for the Customer
curl https://api.stripe.com/v1/customer_sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -X "POST" \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "components[mobile_payment_element][enabled]"=true \
  -d "components[mobile_payment_element][features][payment_method_save]"=enabled \
  -d "components[mobile_payment_element][features][payment_method_redisplay]"=enabled \
  -d "components[mobile_payment_element][features][payment_method_remove]"=enabled

# Create a PaymentIntent
curl https://api.stripe.com/v1/payment_intents \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -X "POST" \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "amount"=1099 \
  -d "currency"="eur" \
  # 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 application_fee_amount="123" \
  -d "transfer_data[destination]"=
"{{CONNECTED_ACCOUNT_ID}}" \

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, alcanza el secreto de cliente del PaymentIntent, el secreto de cliente de la sesión de este, 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.createWithCustomerSession(
          id = networkResult.customer,
          clientSecret = networkResult.customerSessionClientSecret
        )
        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

@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.createWithCustomerSession(
          id = networkResult.customer,
          clientSecret = networkResult.customerSessionClientSecret
        )
        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.

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 tarjeta Test card suite. El conjunto de pruebas admite el uso de tarjetas de prueba de Stripe.

Debes probar Google Pay usando un dispositivo Android físico en lugar de un dispositivo simulado, en un país donde se admite Google Pay. Inicia sesión en una cuenta 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

Una integración de ejemplo está disponible en nuestro 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.

OpcionalHabilitar métodos de pago adicionales

Destino

En nombre y representación de

Configura los métodos de pago para tu cuenta desde la Págona de métodos de pago en el Dashboard de Stripe. Los pagos con tarjeta, Google Pay y Apple Pay se habilitan de forma predeterminada, pero puedes habilitarlos y deshabilitarlos según sea necesario. Tus cuentas conectadas no pueden personalizar sus propios métodos de pago.

Antes de que Stripe muestre el formulario de pago a un cliente, 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 aceptados. El formulario de pago da prioridad a los métodos de pago que aumentan la conversión y guardan mayor relación con la moneda y la ubicación del cliente. Los métodos de pago menos prioritarios se ocultan en un menú de contenido adicional.

Cobra comisiones

Cuando se procesa un pago, en lugar de transferir el importe total de la transacción a una cuenta conectada, tu plataforma puede decidir tomar una parte del importe de la transacción en forma de comisiones. Puedes establecer el precio de las comisiones de dos maneras diferentes:

• Utiliza la herramienta de tarifas de la plataforma para establecer y probar las reglas de comisiones de la plataforma. Esta función que no requiere programación del Dashboard de Stripe solo está disponible actualmente para plataformas responsables de pagar las comisiones de Stripe.

• Establece tus reglas de tarifas internamente, especificando las comisiones directamente en un PaymentIntent utilizando el parámetro application_fee_amount o transfer_data[amount]. Las comisiones establecidas con este método anulan la lógica de tarifas especificada en la herramienta de tarifas de la plataforma.

application_fee_amount

transfer_data[amount]

Cuando se crean cargos 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

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=1000 \
  -d currency=usd \
  -d "automatic_payment_methods[enabled]"=true \
  -d application_fee_amount=123 \
  -d "transfer_data[destination]"=
"{{CONNECTED_ACCOUNT_ID}}"

Una vez cobrada la comisión de la plataforma, se crea un objeto de comisión de la plataforma. Puedes ver una lista de las comisiones de la plataforma en el Dashboard, con las comisión de la plataforma o en Sigma. También puedes utilizar la propiedad amount en el objeto de la comisión de la plataforma para realizar informes detallados de las comisiones.

Si usas un application_fee_amount, ten en cuenta que:

• El application_fee_amount no puede superar el importe total de la transacción.
• El application_fee_amount siempre se calcula en la misma moneda que la transacción.
• La comisión de la plataforma se liquida en la moneda de cobro de la cuenta conectada. En el caso de los cargos a un destino transfronterizos, esto podría diferir de la moneda de cobro de tu plataforma.
• Tu plataforma paga la comisión de Stripe después de que se transfiere el application_fee_amount a tu cuenta.
• No se aplican comisiones adicionales de Stripe al importe.
• Tu plataforma puede usar la medición, notificación y verificación de comisiones de la plataforma incorporadas para conciliar las comisiones cobradas.
• En los dashboards o componentes alojados en Stripe, como el componente Datos de pago, tu cuenta conectada puede ver tanto el importe total como el importe de la comisión de la plataforma.

Flujo de fondos con cargos a un destino

Con el código anterior, el importe total del cargo (USD 10.00) se agrega al saldo pendiente de la cuenta conectada. El application_fee_amount (USD 1.23) se deduce del importe del cargo y se transfiere a tu plataforma. Las comisiones de Stripe (USD 0.59) se deducen del saldo de la cuenta de tu plataforma. El importe de la comisión de la plataforma menos las comisiones de Stripe (USD 1.23 − USD 0.59 = USD 0.64) permanece en el saldo de la cuenta de tu plataforma.

El application_fee_amount estará a disposición de la cuenta de la plataforma conforme a su calendario habitual de transferencias, como si se tratara de fondos de cualquier otro cargo de Stripe.

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.

Emitir reembolsos

Si usas la API Payment Intents, los reembolsos deben emitirse por el último cargo creado.

Los cargos creados en la cuenta de la plataforma se pueden rembolsar usando la clave secreta de la cuenta de la plataforma. Cuando se rembolsa un cargo con un transfer_data[destination], de manera predeterminada, la cuenta de destino conserva los fondos transferidos y deja que la cuenta de la plataforma cubra el saldo negativo del rembolso. Para retirar los fondos de la cuenta conectada para cubrir el rembolso, establece el parámetro reverse_transfer en true al crear el rembolso:

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

De forma predeterminada, se rembolsa el cargo total, pero puedes crear un rembolso parcial definiendo el valor de amount con un número entero positivo.

Si el rembolso implica que se devuelve el total del cargo, se revierte el total de la transferencia. De lo contrario, se revierte un importe proporcional de la transferencia.

Reembolsar comisiones de la plataforma

Cuando se reembolsa un cargo con una comisión de la plataforma, de manera predeterminada, la cuenta de la plataforma conserva los fondos de la comisión. Para volver a enviar los fondos de la comisión de la plataforma a la cuenta conectada, establece el parámetro refund_application_fee en true al crear el reembolso:

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

Ten en cuenta que si rembolsas la comisión de la aplicación para un cargo a un Destino, también debes revertir la transferencia. Si el rembolso implica que se devuelve el total del cargo, también se rembolsa el total de la comisión. De lo contrario, se rembolsa un importe proporcional de la comisión.

Como alternativa, puedes especificar un valor false para refund_application_fee y reembolsar la comisión de la plataforma por separado a través de la API.

Reembolsos fallidos

Si un reembolso falla, o lo cancelas, el monto del reembolso fallido regresa al saldo de Stripe de tu cuenta de plataforma. Crea un envío de fondos para transferir los fondos a la cuenta conectada, según sea necesario.

Gestionar disputas

En el caso de los cargos de destino, con o sin on_behalf_of, Stripe debita los montos de las disputas y las comisiones de tu cuenta de la plataforma.

Te recomendamos configurar un webhook para recibir notificaciones de los eventos creados por la disputa. Cuando eso sucede, puedes intentar recuperar los fondos de la cuenta conectada revirtiendo la transferencia a través del Dashboard o creando una revocación de transferencia.

Si la cuenta conectada tiene un saldo negativo, Stripe intenta debitar de su cuenta externa si debit_negative_balances se establece en true.

Si impugnas la disputa y esta se resuelve a tu favor, puedes volver a transferir los fondos que revertiste previamente a la cuenta conectada. Si tu plataforma tiene un saldo insuficiente, la transferencia falla. Para evitar errores por saldo insuficiente, agrega fondos a tu saldo de Stripe.

Transferencias omitidas por estado de cuenta

Los pagos que utilizan métodos de pago asincrónicos (como débito ACH o SEPA) demoran entre la autorización del pago y la disponibilidad de los fondos. Durante este tiempo, si la cuenta destino pierde la funcionalidad requerida de envío de fondos o se cierra, Stripe no puede completar el envío de fondos según lo solicitado originalmente.

Cuando Stripe intenta crear un envío de fondos, pero no puede debido a la pérdida de funcionalidad o eliminación de cuenta, se omite la creación del envío de fondos y los fondos permanecen en el saldo de tu plataforma.

Para detectar transferencias omitidas, escucha el evento webhook charge.updated. Si el valor de transfer_data en el objeto cargo es null, esto indica un envío de fondos omitido.

Cuando detectas un envío de fondos omitido, puedes crear un envío de fondos después de que se resuelva el problema, si corresponde a tu empresa.

Componentes integrados de Connect

Los cargos a un destino son compatibles con los componentes integrados de Connect. Cuando usas el componente integrado de pagos, puedes permitir que tus cuentas conectadas vean la información de pago desde tu sitio. Para los cargos a un destino con on_behalf_of, puedes usar la funcionalidad destination_on_behalf_of_charge_management para permitir que tus cuentas conectadas vean detalles adicionales, gestionen reembolsos y disputas, y permitan capturar pagos.

Los siguientes componentes muestran información para cargos a un destino:

• Componente de pago: muestra todos los pagos y las disputas de una cuenta.

• Detalles de pagos: Muestra todos los pagos y las disputas de una cuenta.

• Componente de lista de disputas: muestra todas las disputas de una cuenta.

• Disputas para un componente de pago: muestra las disputas para un solo pago especificado. Puedes usarlo para incluir funcionalidades para gestionar disputas en una página con tu interfaz de usuario (IU) de pagos.