- Pautas de integración
- Características soportadas (métodos de pago)
- Implementación de una integración de pago mediante explorador
- Pagos con Klarna
Klarna
Klarna AB es un conocido banco sueco que ofrece a los pagadores de Europa una gama de opciones flexibles de financiamiento para la compra de bienes en línea. Mediante los métodos de pago de Klarna, los pagadores pueden pagar inmediatamente, retrasar el pago hasta después de la entrega o repartir el costo en un número de pagos.
Los métodos de pago de Klarna se admiten en el <<paymentGateway>>. Esta página describe los detalles de la integración específicos de los métodos de pago de Klarna. Se recomienda que lea las pautas de integración para los pagos mediante explorador, antes de crear una integración de Klarna.
Prerrequisitos
Para ofrecer los métodos de pago de Klarna mediante el <<paymentGateway>>:
- usted debe estar registrado con su proveedor de servicios de pago mediante explorador;
- su perfil de negocio en el <<paymentGateway>> se debe configurar usando los detalles de su cuenta con el proveedor de servicios de pago mediante explorador; y
- debe tener una cuenta bancaria en una de las monedas soportadas registrada en su cuenta de negocio en su proveedor de servicios de pago mediante explorador.
Klarna Pay Later
Klarna AB es un banco sueco que ofrece Klarna Pay Later, que es una opción de pago atrasado. Los pagadores revisan los artículos que el negocio les envía y se quedan solo con los artículos que tienen la intención de comprar y pagar, y devuelven los artículos no deseados. Para los pagos aprobados, Klarna AB asume todos los riesgos de crédito y fraude, y le paga a usted por el monto total de un pedido. Asegúrese de reembolsar cada artículo devuelto por los pagadores mediante la operación Refund. Los pagadores pueden cancelar pedidos al efectuar un reembolso por el monto total de la compra. A continuación, Klarna factura a los pagadores y cobra el pago, enviando notificaciones por correo electrónico y recordatorios antes de la fecha de vencimiento del pago.
Klarna Pay Later admite transacciones que se originan en varios países con sus monedas correspondientes.
| País | Moneda |
|---|---|
| Austria (AUT) | EUR |
| Alemania (DEU) | EUR |
| Países Bajos (NLD) | EUR |
| Finlandia (FIN) | EUR |
| Suecia (SWE) | SEK |
| Noruega (NOR) | NOK |
| Reino Unido (GBR) | GBP |
| Dinamarca (DNK) | DKK |
Klarna Financing
Klarna AB es un banco sueco que ofrece Klarna Financing, que es una opción de pago flexible. Se trata de un acuerdo de financiamiento a largo plazo, en el que los pagadores puede comprar un artículo y pagarlo en un número de pagos. Puede optar por pagar en seis a treinta y seis números de pagos mensuales iguales, incluidos los intereses (si corresponde), pagar un monto mínimo cada mes o cancelar el monto total en un mes.
Klarna Financing admite transacciones que se originan en varios países con sus monedas correspondientes.
| País | Moneda |
|---|---|
| Austria (AUT) | EUR |
| Alemania (DEU) | EUR |
| Países Bajos (NLD) | EUR |
| Finlandia (FIN) | EUR |
| Suecia (SWE) | SEK |
| Noruega (NOR) | NOK |
| Reino Unido (GBR) | GBP |
| Dinamarca (DNK) | DKK |
Klarna Pay Now
Klarna AB es un banco sueco que ofrece Klarna Pay Now, que es una opción de pago inmediato. Los pagadores pueden pagar a través de una transferencia bancaria, un débito directo o cualquier tarjeta.
Klarna Pay Now admite transacciones que se originan en varios países con sus monedas correspondientes.
| País | Moneda |
|---|---|
| Austria (AUT) | EUR |
| Alemania (DEU) | EUR |
| Países Bajos (NLD) | EUR |
| Suecia (SWE) | SEK |
Integración de Klarna
La integración de <<checkout>> le permite recopilar detalles de pago de los pagadores a través de una interacción que el <<paymentGateway>> hospeda y muestra.
Klarna Pay Later
Desde la API versión 52 en adelante, Klarna Pay Later está disponible automáticamente como método de pago una vez que <<paymentServiceProvider>> lo habilita y configura para este método de pago.
Klarna Financing
Desde la API versión 62 en adelante, Klarna Financing está disponible automáticamente como método de pago una vez que <<paymentServiceProvider>> lo habilita y configura para este método de pago.
Klarna Pay Now
Pronto estará disponible Klarna Pay Now mediante <<checkout>>. Póngase en contacto con <<paymentServiceProvider>> para obtener más información.
Para conocer más detalles, consulte Pagos mediante explorador a través de la integración de <<checkout>>.
La integración de <<directPayment>> le permite ofrecer los métodos de pago de Klarna en su propia página de pago.
Klarna Pay Later
Klarna Pay Later es compatible con <<webServicesIntegration>> de la versión 52 en adelante.
Realice la solicitud Initiate Browser Payment donde sourceOfFunds.type = KLARNA_PAY_LATER y browserPayment.operation = PAY (Klarna no admite la operación Authorize).
sourceOfFunds.type = KLARNA al realizar la solicitud Initiate Browser Payment.
{
"apiOperation": "INITIATE_BROWSER_PAYMENT",
"browserPayment": {
"operation": "PAY",
"returnUrl": "<your_merchant_URL>"
},
"customer": {
"email": "john.smith@example.com",
"firstName": "John",
"lastName": "Smith",
"mobilePhone": "01234567890"
},
"billing": {
"address": {
"street": "10 Upper Bank Street",
"postcodeZip": "E14 5NP",
"city": "London",
"country": "GBR"
}
},
"order": {
"amount": 57.2,
"currency": "GBP",
"item": [
{
"name": "Blue Jeans",
"quantity": "1",
"unitPrice": 70.83,
"unitDiscountAmount": 48.16,
"unitTaxAmount": 4.53,
"detail": {
"unitTaxRate": 0.2
}
},
{
"name": "Red Shirt",
"quantity": "1",
"unitPrice": 20.83,
"unitTaxAmount": 4.17,
"detail": {
"unitTaxRate": 0.2
}
},
{
"name": "Shipping & Handling",
"quantity": "1",
"unitPrice": 4.17,
"unitTaxAmount": 0.83,
"detail": {
"unitTaxRate": 0.2
}
}
]
},
"sourceOfFunds": {
"type": "KLARNA_PAY_LATER"
}
}
Klarna Financing
Klarna Financing es compatible con <<webServicesIntegration>> de la versión 61 en adelante.
Realice una solicitud Initiate Browser Payment donde sourceOfFunds.type = KLARNA_FINANCING y browserPayment.operation = PAY (Klarna no admite la operación Authorize).
{
"apiOperation":"INITIATE_BROWSER_PAYMENT",
"browserPayment":{
"operation":"PAY",
"returnUrl":"<your_merchant_URL>"
},
"customer":{
"email":"john.smith@example.com",
"firstName":"John",
"lastName":"Smith",
"mobilePhone":"01234567890"
},
"billing":{
"address":{
"street":"10 Upper Bank Street",
"postcodeZip":"E14 5NP",
"city":"London",
"country":"GBR"
}
},
"order":{
"amount":99.2,
"currency":"GBP",
"item":[
{
"name":"Blue Jeans",
"quantity":"1",
"unitPrice":70.83,
"unitDiscountAmount":48.16,
"unitTaxAmount":4.53,
"detail":{
"unitTaxRate":0.2
}
},
{
"name":"Red Shirt",
"quantity":"1",
"unitPrice":20.83,
"unitTaxAmount":4.17,
"detail":{
"unitTaxRate":0.2
}
},
{
"name":"Leather Belt",
"quantity":"1",
"unitPrice":25,
"unitTaxAmount":5,
"detail":{
"unitTaxRate":0.2
}
},
{
"name":"Baseball Cap",
"quantity":"1",
"unitPrice":10,
"unitTaxAmount":2,
"detail":{
"unitTaxRate":0.2
}
},
{
"name":"Shipping and Handling",
"quantity":"1",
"unitPrice":4.17,
"unitTaxAmount":0.83,
"detail":{
"unitTaxRate":0.2
}
}
]
},
"sourceOfFunds":{
"type":"KLARNA_FINANCING"
}
}
Klarna Pay Now
Klarna Pay Now es compatible con <<webServicesIntegration>> de la versión 63 en adelante.
Realice una solicitud Initiate Browser Payment donde sourceOfFunds.type = KLARNA_PAY_NOW y browserPayment.operation = PAY (Klarna no admite la operación Authorize).
{
"apiOperation":"INITIATE_BROWSER_PAYMENT",
"billing":{
"address":{
"city":"Edinburgh",
"company":"MPGS",
"country":"DEU",
"postcodeZip":"EH123AB",
"stateProvince":"Scotland",
"street":"OceanPoint",
"street2":"OceanDrive"
}
},
"browserPayment":{
"operation":"PAY",
"returnUrl":"<your_merchant_URL>"
},
"customer":{
"account":{
"id":"custoAccount"
},
"dateOfBirth":"1999-12-31",
"email":"john.smith@example.com",
"firstName":"John",
"lastName":"Smith",
"mobilePhone":"01234567890",
"nationalId":"X4RTBPFW4"
},
"order":{
"amount":"154.16",
"currency":"EUR",
"item":[
{
"name":"Diesel Jeans",
"quantity":"1",
"unitPrice":"70.83"
},
{
"name":"Adidas Trainers",
"quantity":"1",
"unitPrice":"83.33"
}
]
},
"shipping":{
"address":{
"city":"Shipsville",
"country":"GBR",
"postcodeZip":"EH67DX",
"stateProvince":"Scotland",
"street":"2ShippingHeights",
"street2":"ShipsDrive"
},
"contact":{
"email":"john.smith@example.com",
"firstName":"John",
"lastName":"Smith"
}
},
"sourceOfFunds":{
"type":"KLARNA_PAY_NOW"
}
}
Además de los campos estándar obligatorios en una solicitud de pago mediante explorador, proporcione la siguiente información obligatoria para el procesamiento de los pagos con Klarna.
Dirección de facturación y detalles de contacto
Estos campos son obligatorios, a menos que se indique lo contrario, y son necesarios para respaldar los procesos de evaluación de riesgos y verificación de crédito de Klarna. La información de contacto del pagador se utiliza para comunicarse con el pagador y para entregar las facturas electrónicas y las notificaciones de pago.
billing.address.citybilling.address.countrybilling.address.postcodeZipbilling.address.streetcustomer.emailcustomer.firstNamecustomer.lastNamecustomer.mobilePhone: este campo es obligatorio cuando no se proporcionacustomer.phone.customer.phone: este campo es obligatorio cuando no se proporcionacustomer.mobilePhone.customer.nationalId: este campo es opcional.
Dirección de compra y detalles de contacto
Estos campos son obligatorios cuando se proporciona un valor para cualquier campo shipping.address.* o shipping.contact.*.
shipping.address.cityshipping.address.countryshipping.address.postcodeZipshipping.address.streetshipping.contact.emailshipping.contact.firstNameshipping.contact.lastName
Detalles de los artículos del pedido
Proporcione todos los detalles sobre cada artículo del pedido que se compró, para que Klarna pueda validar y mostrar correctamente esta información a los pagadores y para respaldar los procesos de verificación de riesgo y crédito de Klarna.
order.item[n].nameorder.item[n].quantity: el valor de este campo debe ser un entero.order.item[n].unitPriceorder.item[n].unitDiscountAmount: este campo es obligatorio cuando se ha aplicado un descuento al artículo y debe proporcionarse si se ingresa un valor en el campoorder.discount.amount.order.item[n].unitTaxAmount: este campo es obligatorio cuando un pagador tiene que pagar impuestos sobre el artículo.order.item[n].detail.unitTaxRate: este campo es obligatorio cuando se ha proporcionado un valor para el monto del impuesto unitario.
Transporte y envío
El monto total del impuesto que se debe pagar por el pedido se muestra a los pagadores durante el flujo de pago. Si el monto que se debe pagar por el transporte y envío incluye el impuesto, debe crear una línea de pedido para representar el transporte y envío, de modo que se pueda proporcionar el monto del impuesto discreto. Si no se aplica el impuesto, el monto de transporte y envío se puede proporcionar en el campo order.shippingAndHandlingAmount.
Idioma preferido
Para configurar el idioma que prefiere que Klarna utilice para las páginas que se muestran a los pagadores, complete el campo browserPayment.preferredLanguage en la solicitud de Initiate Browser Payment. Sin embargo, Klarna solo admite el idioma nacional principal del billing.address.country o inglés.
Contracargos
Los pagos de Klarna conllevan el riesgo de contracargos. Si los pagadores disputan con éxito un pago con Klarna, se creará una transacción de contracargo en el pedido. Para obtener más información, consulte transacción de contracargo.
Cómo interpretar el resultado de la transacción
La tabla siguiente muestra los códigos de respuesta de transacción para los posibles escenarios que puede encontrar después de iniciar un pago con Klarna.
Respuesta de Initiate Browser Payment |
Qué significa esto... |
|---|---|
response.gatewayCode=SUBMITTEDresult=SUCCESS |
Redirigir al pagador utilizando la URL proporcionada en la respuesta. |
Respuesta de Retrieve Transaction/Retrieve Order |
Qué significa esto... |
response.gatewayCode=APPROVEDresult=SUCCESS |
El pago se realizó correctamente. |
response.gatewayCode=PENDINGresult=PENDING |
<<paymentGateway>> está esperando una notificación del adquirente sobre el resultado del pago. Pruebe RETRIEVE_TRANSACTION nuevamente más tarde o escuche las notificaciones de <<paymentGateway>>. |
response.gatewayCode=CANCELLEDresult=FAILURE |
El pagador canceló la interacción para este pago. Ofrezca al pagador la opción de probar otro método de pago. |
response.gatewayCode=DECLINED or ACQUIRER_SYSTEM_ERRORresult=FAILURE |
El pago fue rechazado. Ofrezca al pagador la opción de probar otro método de pago. En caso de un ACQUIRER_SYSTEM_ERROR, puede consultar con el adquirente el motivo del error del pago, o bien puede intentar RETRIEVE_TRANSACTION de nuevo. |
response.gatewayCode=TIMED_OUTresult=FAILURE |
Trate esto como un pago rechazado. El <<paymentGateway>> hará lo posible para asegurarse de que la transacción no se puede realizar o revertirá la transacción. |
ID de pedido de Klarna
Para los pagos aprobados, el <<paymentGateway>> le proporcionará el ID que Klarna asignó a este pedido en el campo transaction.acquirer.additionalResponseData. Esta información puede ser útil para las comunicaciones que pueda tener directamente con Klarna.
Notificaciones de webhook
Si está suscrito a las notificaciones de webhook del <<paymentGateway>>, puede que reciba notificaciones adicionales sobre actualizaciones del estado de financiamiento y contracargos.
Prueba de su integración
El <<paymentGateway>> proporciona un emulador de pagos mediante explorador que le permite probar su integración con Klarna.