# Klarna

Klarna is a "Buy Now, Pay Later" payment method allowing your customer to pay in installments.

Note
Make yourself familiar with our [API principles](/products/reference/api-principles) to ensure a resilient integration.

details
summary
Product overview
#### Capabilities

* defer payment by 30 days
* spread the cost over three (four in some markets) equal interest-free installments
* spread the cost up to 36 months (with financing)
* pay the full amount immediately with "Pay Now" for card, local domestic or local bank transfer payments


#### Brand and marketing guidelines

Follow the link for the latest guidelines from [Klarna](https://docs.klarna.com/marketing/solutions/grab-and-go/).

#### Feature summary

| Payment type | Countries | Recurring | Reversals | Partial reversals | Disputes | Auth only |
|  --- | --- | --- | --- | --- | --- | --- |
| Pay Now, Pay in Parts, Pay Later, Financing | AT,BE,FI,DE,NL,NO,ES,SE,CH | ❌ | ✅ | Partial refund - yesPartial cancel- No | Handled directly via Klarna. Worldpay will deduct the funds if the dispute is lost. | ✅ |


Note
Refunds are completed through Klarna to your customer's account within 365 days and you can submit multiple partial refunds for one payment.

#### Acceptance currencies

| Currency | Currency codes |
|  --- | --- |
| Czech Koruna | CZK |
| Danish Krone | DKK |
| Euro | EUR |
| Norwegian Krone | NOK |
| Polish Złoty | PLN |
| Pound Sterling | GBP |
| Swedish Krona | SEK |
| Swiss Franc | CHF |


## Get started

Get started using our [API reference](/products/apms/openapi) and set your headers.

## Request

`POST` `https://try.access.worldpay.com/apmPayments`

### Example request

Guest
Recurring
Token
Information
You must settle the payment, using next action links, when using Klarna with a token.

### Parameters

Recommendation
We suggest you provide the `cancelURL`,`failureURL`, `pendingURL` and  `successURL` attribute to redirect your customer to, once you have received the payment result.

## Response

#### Successful response

* an HTTP code 201
* an id which is unique to the payment - we recommend storing the "id" as this can be used to manage the payment later
* a url to redirect your customer to the APM provider to complete the payment
* a link to query the payment status
* an object which will give flow information such as `method` (e.g. `klarna`), type (e.g. `direct` for the Redirect URL flow)
* an action `id` generated by us identifying a single merchant interaction (e.g. `cmdYNdIHBPJwbkjLiykzTx0`)


### Example response

Guest response
{
  "paymentId": "uK9Oh5zz4yKhGuFofhhnC056-K6qn-w8Krt2pRT2oSzwh_KRcHUrrs1qJtQso9gjgJ_wwjT869eMBB_T4PM4D6HdjtgfjDBh7htEkjHxp4Q_KzkRIENkZoejad--FtjVrMslJn1mvz4mwr-TuKlP9ZAhBEzSApkfhL__fXCo-vMkR1a2Zrj_R8rGSgu6m2Wd",
  "lastEvent": "pending",
  "_links": {
    "self": {
      "href": "https://try.access.worldpay.com/apmPayments/uK9Oh5zz4yKhGuFofhhnC056-K6qn-w8Krt2pRT2oSzwh_KRcHUrrs1qJtQso9gjgJ_wwjT869eMBB_T4PM4D6HdjtgfjDBh7htEkjHxp4Q_KzkRIENkZoejad--FtjVrMslJn1mvz4mwr-TuKlP9ZAhBEzSApkfhL__fXCo-vMkR1a2Zrj_R8rGSgu6m2Wd"
    }
  },
  "_actions": {},
  "redirect": "https://secure-test.worldpay.com/jsp/test/shopper/APMSTSimulator.jsp?customerRef=3417843726&paymentMethod=KLARNA_PAYNOW&country=DE",
  "paymentInstrument": {
    "method": "klarna",
    "type": "direct"
  },
  "commandId": "cmdEy5vwB0krLe9eMwAcE66c0"
}
Recurring response
{
  "paymentId": "uK9Oh5zz4yKhGuFofhhnC056-K6qn-w8Krt2pRT2oSzwh_KRcHUrrs1qJtQso9gjgJ_wwjT869eMBB_T4PM4D6HdjtgfjDBh7htEkjHxp4Q_KzkRIENkZoejad--FtjVrMslJn1mvz4mwr-TuKlP9ZAhBEzSApkfhL__fXCo-vMkR1a2Zrj_R8rGSgu6m2Wd",
  "lastEvent": "pending",
  "_links": {
    "self": {
      "href": "https://try.access.worldpay.com/apmPayments/uK9Oh5zz4yKhGuFofhhnC056-K6qn-w8Krt2pRT2oSzwh_KRcHUrrs1qJtQso9gjgJ_wwjT869eMBB_T4PM4D6HdjtgfjDBh7htEkjHxp4Q_KzkRIENkZoejad--FtjVrMslJn1mvz4mwr-TuKlP9ZAhBEzSApkfhL__fXCo-vMkR1a2Zrj_R8rGSgu6m2Wd"
    }
  },
  "_actions": {},
  "redirect": "https://secure-test.worldpay.com/jsp/test/shopper/APMSTSimulator.jsp?customerRef=3417843726&paymentMethod=KLARNA_PAYNOW&country=DE",
  "paymentInstrument": {
    "method": "klarna",
    "type": "klarna/token"
  },
  "commandId": "cmdEy5vwB0krLe9eMwAcE66c0"
}
Token response
{
  "paymentId": "uK9Oh5zz4yKhGuFofhhnC056-K6qn-w8Krt2pRT2oSzwh_KRcHUrrs1qJtQso9gjgJ_wwjT869eMBB_T4PM4D6HdjtgfjDBh7htEkjHxp4Q_KzkRIENkZoejad--FtjVrMslJn1mvz4mwr-TuKlP9ZAhBEzSApkfhL__fXCo-vMkR1a2Zrj_R8rGSgu6m2Wd",
  "lastEvent": "authorized",
  "_links": {
    "self": {
      "href": "https://try.access.worldpay.com/apmPayments/uK9Oh5zz4yKhGuFofhhnC056-K6qn-w8Krt2pRT2oSzwh_KRcHUrrs1qJtQso9gjgJ_wwjT869eMBB_T4PM4D6HdjtgfjDBh7htEkjHxp4Q_KzkRIENkZoejad--FtjVrMslJn1mvz4mwr-TuKlP9ZAhBEzSApkfhL__fXCo-vMkR1a2Zrj_R8rGSgu6m2Wd"
    }
  },
  "_actions": {},
  "redirect": "",
  "paymentInstrument": {
    "method": "klarna",
    "type": "klarna/token",
    "tokenId": "11c03afa-3449-14fd-997e-55510cf01f27",
    "country": "DE",
    "productType": "payLater"
  },
  "commandId": "cmdEy5vwB0krLe9eMwAcE66c0"
}
Error response
{
  "errorName": "bodyDoesNotMatchSchema",
  "message": "The json body provided does not match the expected schema",
  "validationErrors": [
    {
      "errorName": "fieldHasInvalidValue",
      "message": "Field is mandatory",
      "jsonPath": "$.instruction.value.amount"
    }
  ]
}
#### Errors

Check out our API reference for the full [error code schema](/products/apms/openapi/other/payment#other/payment/response&c=400).

**Next steps**

[Manage your Klarna payment](/products/apms/manage/)