Nuvei - Klarna

Configure Klarna via Nuvei as a payment method in Gr4vy.

Nuvei is a global payment provider that provides comprehensive payment processing solutions across multiple payment methods and regions.

Klarna is a buy now, pay later (BNPL) payment method that lets buyers pay over time through a redirect approval flow.

Setup

Please follow the common Nuvei instructions to get set up with Nuvei.

After setting up your Nuvei account, ask Nuvei to complete the following Klarna-specific account configuration:

1. Enable Klarna as a payment method on your merchant account.
2. Enable sale mode for all Klarna transactions on your merchant account. Nuvei defaults Klarna to auth-settle mode, and Gr4vy supports only sale mode.

Features

Nuvei Klarna payments support the following features:

• Refunds - Refund transactions in full or in part
• Partial refunds - Issue multiple partial refunds up to the captured amount
• Transaction synchronization - Keep payment statuses synchronized with Nuvei
• Redirect checkout - Redirect buyers to approve the payment

Supported countries

Nuvei supports transactions from buyers in the following countries:

Country code	Country code	Country code	Country code	Country code	Country code	Country code	Country code
AT	BE	CH	CZ	DE	DK	ES	FI
FR	GB	GR	HU	IE	IT	NL	NO
PL	PT	RO	SE	SK

Supported currencies

Nuvei supports processing payments in the following currencies:

Currency code	Currency code	Currency code	Currency code	Currency code	Currency code	Currency code	Currency code
CHF	CZK	DKK	EUR	GBP	NOK	PLN	RON
SEK

Limitations

The following features are not supported by this connector:

• Auth-settle mode - Klarna transactions require sale mode
• Delayed capture - Authorization and capture must happen together
• Partial capture - Cannot capture a portion of the authorized amount
• Void - Cannot cancel transactions once initiated
• Payment method tokenization - Cannot store payment methods for recurring transactions
• Zero auth - Zero-dollar verification transactions are not supported
• Settlement reporting - Settlement reporting is not available

Integration

For Klarna, the default integration for Nuvei is through a redirect to a hosted payments page.

Start by creating a new transaction with the following required fields.

C#

var transaction = await client.Transactions.CreateAsync(
  transactionCreate: new TransactionCreate()
  {
    Amount = 1299,
    Currency = "GBP",
    Country = "GB",
    PaymentMethod =
      TransactionCreatePaymentMethod.CreateCheckoutSessionWithUrlPaymentMethodCreate(
        new RedirectPaymentMethodCreate()
        {
          Method = "klarna",
          RedirectUrl = "https://example.com/callback",
        }
      ),
  }
);

After the transaction is created, the API response includes payment_method.approval_url and the buyer_approval_pending status.

{
  "type": "transaction",
  "id": "ea1efdd0-20f9-44d9-9b0b-0a3d71e9b625",
  "payment_method": {
    "type": "payment-method",
    "approval_url": "https://cdn.sandbox.spider.gr4vy.app/connectors/nuvei/apm.html?token=..."
  },
  "method": "klarna"
}

Redirect the buyer to the approval_url so they can complete authentication and approve the payment. After approval the buyer is redirected to the redirect_url you provided when creating the transaction. Do not rely solely on the redirect - either poll the transaction or (recommended) rely on webhooks to detect the final status (for example capture_succeeded or failure states).

Required fields

Nuvei requires the following fields to be collected during checkout for Klarna transactions:

• First name and last name
• Billing country
• Email address