myonlinestore / omnipay-klarna-checkout
Klarna Checkout gateway for Omnipay payment processing library
Installs: 93 258
Dependents: 0
Suggesters: 0
Security: 0
Stars: 12
Watchers: 15
Forks: 12
Open Issues: 6
Requires
- php: ^7.4 | ^8.0
- ext-json: *
- omnipay/common: ^3.1
Requires (Dev)
- myonlinestore/coding-standard: ^3.1
- myonlinestore/php-devtools: ^0.2
- omnipay/tests: ^4.1
- vimeo/psalm: ^4.18
- dev-master
- 5.0
- 4.0
- 3.1
- 3.0.12
- v3.0.11
- v3.0.10
- v3.0.9
- v3.0.8
- v3.0.7
- v3.0.6
- v3.0.5
- v3.0.4
- v3.0.3
- v3.0.2
- v3.0.1
- v3.0.0
- v2.0.1
- v2.0.0
- v1.0.31
- v1.0.30
- v1.0.29
- v1.0.28
- v1.0.27
- v1.0.26
- v1.0.25
- v1.0.24
- v1.0.23
- v1.0.22
- v1.0.21
- v1.0.20
- v1.0.19
- v1.0.18
- v1.0.17
- v1.0.16
- v1.0.15
- 1.0.14
- 1.0.13
- 1.0.12
- 1.0.11
- 1.0.10
- 1.0.9
- v1.0.8
- v1.0.7
- v1.0.6
- v1.0.5
- v1.0.4
- v1.0.3
- v1.0.2
- v1.0.1
- v1.0
- dev-v2-authentication
- dev-release-2.0
- dev-purchase_country-to-string
This package is auto-updated.
Last update: 2024-03-01 13:01:17 UTC
README
This repository is no longer being maintained.
Omnipay: Klarna Checkout
Introduction
Omnipay is a framework agnostic, multi-gateway payment processing library for PHP 5.6+. This package implements Klarna Checkout support for Omnipay.
Installation
To install, simply add it to your composer.json
file:
$ composer require myonlinestore/omnipay-klarna-checkout
Initialization
First, create the Omnipay gateway:
$gateway = Omnipay\Omnipay::create('\MyOnlineStore\Omnipay\KlarnaCheckout\Gateway'); // or $gateway = new MyOnlineStore\Omnipay\KlarnaCheckout\Gateway(/* $httpClient, $httpRequest */);
Then, initialize it with the correct credentials:
$gateway->initialize([ 'username' => $username, 'secret' => $secret, 'api_region' => $region, // Optional, may be Gateway::API_VERSION_EUROPE (default) or Gateway::API_VERSION_NORTH_AMERICA 'testMode' => false // Optional, default: true ]); // or $gateway->setUsername($username); $gateway->setSecret($secret); $gateway->setApiRegion($region);
Usage
For general usage instructions, please see the main Omnipay repository.
General flow
- Create a Klarna order
- Update transaction (if required)
- Render the Iframe
- Respond to redirects to
checkoutUrl
orconfirmation_url
- Respond to checkout callbacks
- Respond to the request to
push_url
(indicates order was completed by client) with a ackowledgement - Extend authorization (if required)
- Update the merchant address (if required)
- Perform one or more capture(s), refund(s) or void operations
Authorize
To create a new order, use the authorize
method:
$data = [ 'amount' => 100, 'tax_amount' => 20, 'currency' => 'SEK', 'locale' => 'SE', 'purchase_country' => 'SE', 'notify_url' => '', // https://developers.klarna.com/api/#checkout-api__ordermerchant_urls__validation 'return_url' => '', // https://developers.klarna.com/api/#checkout-api__ordermerchant_urls__checkout 'terms_url' => '', // https://developers.klarna.com/api/#checkout-api__ordermerchant_urls__terms 'validation_url' => '', // https://developers.klarna.com/api/#checkout-api__ordermerchant_urls__validation 'items' => [ [ 'type' => 'physical', 'name' => 'Shirt', 'quantity' => 1, 'tax_rate' => 25, 'price' => 100, 'unit_price' => 100, 'total_tax_amount' => 20, ], ], ]; $response = $gateway->authorize($data)->send()->getData();
This will return the order details as well as the checkout HTML snippet to render on your site.
Render Iframe
Klarna Checkout requires an iframe to be rendered when authorizing payments:
$response = $gateway->fetchTransaction(['transactionReference' => 'a5bec272-d68d-4df9-9fdd-8e35e51f92ab']) ->send(); echo $response->getData()['checkout']['html_snippet'];
After submitting the form within the iframe,
Klarna will redirect the client to the provided confirmation_url
(success)
or checkout_url
(failure)`.
Update transaction
While an order has not been authorized (completed) by the client, it may be updated:
$response = $gateway->updateTransaction([ 'transactionReference' => 'a5bec272-d68d-4df9-9fdd-8e35e51f92ab', 'amount' => 200, 'tax_amount' => 40, 'currency' => 'SEK', 'locale' => 'SE', 'purchase_country' => 'SE', 'items' => [/*...*/], ])->send();
The response will contain the updated order data.
Extend authorization
Klarna order authorization is valid until a specific date, and may be extended (up to a maximum of 180 days). The updated expiration date may then be retrieved with a fetch request
if ($gateway->extendAuthorization(['transactionReference' => 'a5bec272-d68d-4df9-9fdd-8e35e51f92ab'])->send()->isSuccessful()) { $expiration = new \DateTimeImmutable( $gateway->fetchTransaction(['transactionReference' => 'a5bec272-d68d-4df9-9fdd-8e35e51f92ab']) ->send() ->getData()['management']['expires_at'] ); }
Capture
$success = $gateway->capture([ 'transactionReference' => 'a5bec272-d68d-4df9-9fdd-8e35e51f92ab', 'amount' => '995', ])->send() ->isSuccessful();
Fetch
A Klarna order is initially available through the checkout API. After it has been authorized, it will be available through the Order management API (and will, after some time, no longer be available in the checkout API). This fetch request will first check whether the order exitst in the checkout API. If that is not the case, or the status indicates the order is finished, it will also fetch the order from the order management API
$response = $gateway->fetchTransaction(['transactionReference' => 'a5bec272-d68d-4df9-9fdd-8e35e51f92ab']) ->send(); $success = $response->isSuccessful(); $checkoutData = $response->getData()['checkout'] ?? []; $managementData = $response->getData()['management'] ?? [];
API documentation | Checkout | Order management
Acknowlegde
Acknowledge a completed order
$success = $gateway->acknowledge(['transactionReference' => 'a5bec272-d68d-4df9-9fdd-8e35e51f92ab']) ->send() ->isSuccessful();
Refund
$success = $gateway->refund([ 'transactionReference' => 'a5bec272-d68d-4df9-9fdd-8e35e51f92ab', 'amount' => '995', ])->send() ->isSuccessful();
Void
You may release the remaining authorized amount. Specifying a specific amount is not possible.
$success = $gateway->void(['transactionReference' => 'a5bec272-d68d-4df9-9fdd-8e35e51f92ab']) ->send() ->isSuccessful();
Update customer address
This may be used when updating customer address details after the order has been authorized. Success op this operation is subject to a risk assessment by Klarna. Both addresses are required parameters.
$success = $gateway->refund([ 'transactionReference' => 'a5bec272-d68d-4df9-9fdd-8e35e51f92ab', 'shipping_address' => [ 'given_name'=> 'Klara', 'family_name'=> 'Joyce', 'title'=> 'Mrs', 'street_address'=> 'Apartment 10', 'street_address2'=> '1 Safeway', 'postal_code'=> '12345', 'city'=> 'Knoxville', 'region'=> 'TN', 'country'=> 'us', 'email'=> 'klara.joyce@klarna.com', 'phone'=> '1-555-555-5555' ], 'billing_address' => [ 'given_name'=> 'Klara', 'family_name'=> 'Joyce', 'title'=> 'Mrs', 'street_address'=> 'Apartment 10', 'street_address2'=> '1 Safeway', 'postal_code'=> '12345', 'city'=> 'Knoxville', 'region'=> 'TN', 'country'=> 'us', 'email'=> 'klara.joyce@klarna.com', 'phone'=> '1-555-555-5555' ], ])->send() ->isSuccessful();
Update merchant reference(s)
If an order has been authorized by the client, its merchant references may be updated:
$response = $gateway->updateMerchantReferences([ 'merchant_reference1' => 'foo', 'merchant_reference2' => 'bar', ])->send();
Units
Klarna expresses amounts in minor units as described here.