Ir a contenido
Crea una cuenta
 o
inicia sesión
Logotipo de la documentación de Stripe
/
Crear cuenta
Iniciar sesión
ResumenActualiza tu integración
Pagos por Internet
ResumenEncuentra tu caso de usoUse Managed Payments
Métodos de pago
Interfaces de pago
Escenarios de pago
Pagos en persona
Más allá de los pagos

Aceptar un pago con Klarna

Descubre cómo aceptar Klarna, un método de pago internacional de «Compra ahora, paga después»

Aceptar Klarna en tu aplicación consiste en mostrar una vista web para que el cliente autentique su pago. A continuación, el cliente vuelve a tu aplicación y puedes confirmar automáticamente si el pago se ha efectuado correctamente o ha dado error.

Nota

Antes de iniciar la integración, asegúrate de que tu cuenta sea compatible con Klarna. Para ello, accede a la configuración de los métodos de pago.

Configurar 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
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# Available as a gem
sudo gem install stripe
Gemfile
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, añade stripe-android al bloque dependencies de tu archivo app/build.gradle:

build.gradle.kts
Kotlin
Groovy
No results
plugins {
    id("com.android.application")
}

android { ... }

dependencies {
  // ...

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

Nota

Para conocer detalles de la última versión y de versiones anteriores del SDK, consulta la página Versiones de 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:

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 las tareas de desarrollo, y las claves del modo activo cuando publiques tu aplicación.

Los ejemplos de Stripe también utilizan OkHttp y GSON para hacer solicitudes HTTP a un servidor.

Crea un PaymentIntent
Lado del servidor
Lado del cliente

Un PaymentIntent es un objeto que representa tu intención de cobrarle a un cliente y hace el seguimiento del ciclo de vida del proceso de pago en cada etapa.

Command Line
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 "payment_method_types[]"=klarna \
  -d amount=1099 \
  -d currency=eur

Lado del cliente

El PaymentIntent devuelto incluye un client secret que puede utilizar el lado del cliente para completar el proceso de pago de forma segura en lugar de especificar el objeto PaymentIntent completo. En el lado del cliente, solicita un PaymentIntent desde tu servidor y guarda el secreto de cliente.

Kotlin
Java
No results
class KlarnaPaymentActivity: AppCompatActivity() {
    private lateinit var paymentIntentClientSecret: String

    override fun onCreate(savedInstanceState: Bundle?) {
        // ...
        startCheckout()
    }


    private fun startCheckout() {
        // Request a PaymentIntent from your server and store its client secret
    }
}

Envía el pago a Stripe
Lado del cliente

Recupera el secreto de cliente del PaymentIntent que creaste en el paso 2 y llama al método de confirmación del PaymentLauncher. Esto presenta una vista web donde el cliente puede completar el pago. Después, se llama a onActivityResult con el resultado del pago.

Kotlin
Java
No results
class KlarnaPaymentActivity : AppCompatActivity() {
    // ...
    private lateinit var paymentIntentClientSecret: String
    private val paymentLauncher: PaymentLauncher by lazy {
        val paymentConfiguration = PaymentConfiguration.getInstance(applicationContext)
        PaymentLauncher.Companion.create(
            this,
            paymentConfiguration.publishableKey,
            paymentConfiguration.stripeAccountId,
            ::onPaymentResult
        )
    }

    private fun startCheckout() {
        // ...

        val confirmParams = ConfirmPaymentIntentParams
            .createWithPaymentMethodCreateParams(
                paymentMethodCreateParams = paymentMethodCreateParams,
                clientSecret = paymentIntentClientSecret,
                shipping = shippingDetails
            )
        paymentLauncher.confirm(confirmParams)
    }

    private fun onPaymentResult(paymentResult: PaymentResult) {
        when (paymentResult) {
            is PaymentResult.Completed -> {
                // show success UI
            }
            is PaymentResult.Canceled -> {
                // handle cancel flow
            }
            is PaymentResult.Failed -> {
                // handle failures
                // (for example, the customer may need to choose a new payment
                // method)
            }
        }
    }
}

Prueba la integración de Klarna

A continuación, tenemos datos de prueba especialmente elegidos para los países de los clientes actualmente aceptados. En un entorno de prueba, Klarna aprueba o rechaza una transacción en función de la dirección de correo electrónico proporcionada.

AprobadoDenegado
Fecha de nacimiento10-07-197003/05/1994
NombreModo de pruebaJohn
ApellidosPerson-ausnow
CalleWharf StSilverwater Rd.
Número de casa41-5
Código postal48772128
CiudadPort DouglasSilverwater
RegiónQLDNSW
Teléfono+61473752244+61473763254
Correo electrónicocustomer@email.aucustomer+denied@email.au

Autenticación en dos pasos

Cualquier número de seis dígitos es un código válido de autenticación en dos pasos. Utiliza 999999 para que la autenticación no se complete.

Método de reembolso

En el flujo de Klarna, puedes usar los siguientes valores de prueba para probar varios tipos de reembolso:

TipoValor
Adeudo directoDE11520513735120710131
Transferencia bancariaBanco de demostración
Tarjeta de crédito
  • Número: 4111 1111 1111 1111
  • CVV: 123
  • Vencimiento: cualquier fecha válida en el futuro
Tarjeta de débito
  • Número: 4012 8888 8888 1881
  • CVV: 123
  • Vencimiento: cualquier fecha válida en el futuro

OpcionalAutorización y captura separadas

Klarna acepta la autorización y la captura por separado. Si hay un retraso en el pago y la entrega de productos a tu cliente, autoriza el pago primero y captúralo después. En el momento de la captura, Klarna envía un extracto al cliente e inicia las fechas de vencimiento de los pagos correspondientes que deban hacer. Debe capturarse el pago autorizado de Klarna en el transcurso de 28 días a partir de la autorización. De lo contrario, se cancelará automáticamente la autorización y ya no será posible capturar el pago.

  1. Indicarle a Stripe que autorice solamente

    Para indicar que quieres separar la autorización y la captura, establece capture_method en manual al crear el PaymentIntent. Este parámetro le indica a Stripe que solo debe autorizar el importe en la cuenta de Klarna del cliente.

    Command Line
    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 "payment_method_types[]"=klarna \
  -d amount=1099 \
  -d currency=eur \
  -d capture_method=manual

  2. Capturar los fondos

    Una vez que se efectúa la autorización, el estado de PaymentIntent pasa a requires_capture. Para capturar los fondos autorizados, solicita la capture del PaymentIntent. De forma predeterminada, se captura el importe total autorizado; no puedes capturar más de ese importe, pero sí menos.

    Command Line
    cURL
    Stripe CLI
    Ruby
    Python
    PHP
    Java
    Node.js
    Go
    .NET
    No results
    curl https://api.stripe.com/v1/payment_intents/
    {{PAYMENT_INTENT_ID}}
    /capture     \
  -u "
    sk_test_BQokikJOvBiI2HlWgH4olfQ2
    :"     \
  -d amount_to_capture=750

  3. Opcional Cancela la autorización

    Klarna contabiliza cualquier pago autorizado a partir del poder adquisitivo total del cliente dentro de Klarna. Asegúrate de cancelar activamente cualquier pago autorizado que no puedas completar (por ejemplo, si no se pueden enviar los bienes) en cuanto lo sepas.

    Command Line
    cURL
    Stripe CLI
    Ruby
    Python
    PHP
    Java
    Node.js
    Go
    .NET
    No results
    curl https://api.stripe.com/v1/payment_intents/
    {{PAYMENT_INTENT_ID}}
    /cancel     \
  -u "
    sk_test_BQokikJOvBiI2HlWgH4olfQ2
    :"     \
  -d cancellation_reason=abandoned

OpcionalGestiona eventos posteriores al pago

Stripe envía un evento payment_intent.succeeded cuando se completa el pago. Utiliza el Dashboard, un webhook personalizado o una solución de socio para recibir estos eventos y ejecutar acciones como, por ejemplo, enviar un correo electrónico para confirmar el pedido al cliente, registrar la venta en una base de datos o iniciar el flujo de tareas de envío.

Escucha estos eventos en lugar de esperar una devolución de llamada del cliente. Por su parte, 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 los clientes malintencionados podrían manipular la respuesta. Configurar tu integración para escuchar eventos asincrónicos también te ayudará a aceptar más métodos de pago en el futuro. Obtén más información sobre las diferencias entre todos los métodos de pago aceptados.

  • Gestiona eventos manualmente en el Dashboard

    Utiliza el Dashboard para ver tus pagos de prueba en el Dashboard, enviar recibos por correo electrónico, gestionar pagos o reintentar pagos fallidos.

  • Crea un webhook personalizado

    Crea un webhook personalizado para escuchar eventos y crear flujos de pago asíncronos personalizados. Prueba y depura tu integración de webhooks de forma local con la CLI de Stripe.

  • Integra una aplicación prediseñada

    Gestiona eventos empresariales comunes, como la automatización o la comercialización y ventas, integrando una aplicación asociada.

OpcionalPersonaliza la página de pago de Klarna

  • Rellenar automáticamente el formulario de Klarna

    Cuando el cliente decide pagarle a Klarna con una opción de pago diferido (es decir, pagar más tarde, en cuotas o con financiación), Klarna recopila la información necesaria para la evaluación de riesgos y la aprobación. El tipo de información depende del país del cliente. Para la mayoría de los países de Europa, son necesarios los datos completos de facturación y la fecha de nacimiento. Puedes transmitir esta información a través de la API, y el formulario se completará automáticamente cuando el cliente llegue a la página.

    Command Line
    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 "payment_method_types[]"=klarna \
  -d amount=1099 \
  -d currency=eur \
  -d confirm=true \
  --data-urlencode return_url="https://example.com/checkout/complete" \
  -d "payment_method_data[type]"=klarna \
  --data-urlencode "payment_method_data[billing_details][email]"="customer@example.com" \
  -d "payment_method_data[billing_details][name]"="Jenny Rosen" \
  --data-urlencode "payment_method_data[billing_details][phone]"="+4915142321555" \
  -d "payment_method_data[billing_details][address][line1]"="Alexanderplatz 1" \
  -d "payment_method_data[billing_details][address][city]"=Berlin \
  -d "payment_method_data[billing_details][address][postal_code]"=10551 \
  -d "payment_method_data[billing_details][address][country]"=DE \
  -d "payment_method_data[klarna][dob][day]"=10 \
  -d "payment_method_data[klarna][dob][month]"=10 \
  -d "payment_method_data[klarna][dob][year]"=1990
    Captura de pantalla de una página de pago de Klarna rellenada automáticamente con los datos de facturación de la API y personalizada para presentarse en inglés

    Una página de pago de Klarna rellenada automáticamente con los datos de facturación de la API y personalizada para presentarse en inglés para un cliente de Alemania

OpcionalAñade partidas al PaymentIntent

Partidas individuales unificadas con Klarna

Para optimizar las tasas de aprobación cuando te integres con Klarna, incluye datos de line_items para representar lo que hay en el carrito de un comprador. Para obtener acceso anticipado, consulta Partidas individuales de pago.

Pagos fallidos

Klarna tiene en cuenta varios factores a la hora de decidir si acepta o rechaza una transacción (por ejemplo, el tiempo que el comprador lleva utilizando Klarna, el importe pendiente de pago del cliente, el valor del pedido actual).

Cuando el cliente elige un método de pago diferido, Klarna lleva a cabo una evaluación del riesgo antes de aceptar la transacción. Klarna podría rechazar la transacción debido a un resultado insatisfactorio de la evaluación de riesgos, al importe de la transacción o a que el cliente tenga una gran deuda pendiente. Por ello, te recomendamos que presentes otras opciones de pago como card en tu flujo del proceso de compra. En estos casos, el PaymentMethod se separa y el estado del objeto PaymentIntent pasa automáticamente a requires_payment_method.

Los clientes deben efectivizar el pago en el transcurso de 48 horas desde que se les redirige al sitio de Klarna. Si no se realiza ninguna acción después de 48 horas, el PaymentMethod se separa y el estado del objeto PaymentIntent pasa automáticamente de requires_action a requires_payment_method.

En estos casos, informa a tus clientes que deben intentarlo de nuevo con una opción de pago diferente de tu flujo de proceso de compra.

Límites de velocidad de Klarna

Las solicitudes de API a Klarna están sujetas a límites de velocidad adicionales más allá de los límites de velocidad de toda la API de Stripe. Estos límites pueden variar en función de la forma de las solicitudes de API que realices. En general, si realizas más de 50 solicitudes por minuto, es posible que veas alguna limitación de frecuencia en forma de respuestas con el código de estatus HTTP 400`` o 402`. [Contacta con nosotros si te preocupa que tu consumo pueda alcanzar estos niveles, ya que Klarna puede aumentar estos límites según el caso.

Mensajes de error

Los errores en los pagos de Klarna normalmente devuelven uno de los siguientes códigos de fallo. Estos códigos se muestran en el objeto de la API last_payment_error.

Precaución

Antes de la versión de la API 2023-08-16, cada error de Klarna se informaba como payment_intent_authentication_failure. Asegúrate de que la versión de la API esté actualizada para ver los errores detallados que se indican a continuación.

Código de falloExplicación
payment_method_customer_declineEl cliente ha cancelado el proceso de compra en la página de Klarna
payment_method_provider_declineKlarna ha rechazado el pago del cliente
payment_intent_payment_attempt_expiredEl cliente nunca completó el proceso de compra en la página de Klarna y la sesión de pago ha caducado
payment_method_not_availableSe ha producido un error inesperado al intentar utilizar Klarna
¿Te ha sido útil la página?
SíNo