Crea cargos Direct

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:

<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.

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.

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.

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.

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:

// 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.

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.

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()

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.

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

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.

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.

// ...
  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.

// ...
    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.

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:

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.