Download the PHP package limetools/swedbank without Composer

Swedbank Laravel Payment API

License: MIT PHP Version GitHub

A Laravel package for integrating with Swedbank Payment Initiation API V3. This package provides a clean and easy-to-use interface for initiating payments, checking payment status, and retrieving payment providers using Swedbank's Payment Initiation API.

Features

• ✅ Swedbank Payment Initiation API V3 support
• ✅ JWS (JSON Web Signature) authentication
• ✅ Sandbox and Production environments
• ✅ Payment Provider management
• ✅ Payment Status checking
• ✅ Comprehensive logging support
• ✅ Laravel 9, 10, and 11 compatible

Requirements

• PHP >= 8.1
• Laravel >= 9.0
• OpenSSL extension (for JWS signing)

Installation

Via Composer

You can install the package via Composer:

Publish Configuration

Publish the configuration file:

This will create a config/swedbank.php file in your Laravel application.

Configuration

Environment Variables

Add the following environment variables to your .env file:

Important: When storing the private key in .env, make sure to:

• Wrap it in double quotes
• Use \n for newlines
• Keep the entire key on a single line

Example:

Usage

Basic Usage

The package provides a SwedbankPaymentApi class that can be used in several ways:

Using Dependency Injection

Using the Facade

Using the Service Container

Step-by-step integration guide

This is a minimal, end-to-end example to get you from a fresh Laravel install to a working Swedbank payment redirect.

1. Install the package

a) From GitHub (recommended now)

In your application composer.json:

Then install:

2. Publish and configure

Publish the config file:

This creates config/swedbank.php.

Add environment variables to .env (start with sandbox):

Optionally, configure a log channel in config/logging.php:

3. Create routes

In routes/web.php:

4. Create a simple controller

Create app/Http/Controllers/SwedbankPaymentController.php:

This controller is intentionally simple; adapt it to your own Order model and domain logic.

Get Payment Providers

Retrieve a list of available payment providers:

Create Payment Initiation

Initiate a payment transaction:

Get Payment Status

Check the status of a payment:

Get Payment Initiation Form

Get payment initiation form data for a specific provider:

Complete Example

Here's a complete example of a payment flow:

API Reference

SwedbankPaymentApi Methods

getPaymentProviders(string $country, string $clientId, string $privateKey): array

Retrieves a list of available payment providers for the specified country.

Parameters:

• $country - Country code (e.g., 'LT', 'LV', 'EE')
• $clientId - Your Swedbank client ID
• $privateKey - Your private key for signing

Returns: Array of provider information

createPaymentInitiation(array $paymentData, string $clientId, string $privateKey): string

Creates a payment initiation and returns the redirect URL.

Parameters:

• $paymentData - Payment data array (see Swedbank V3 API documentation)
• $clientId - Your Swedbank client ID
• $privateKey - Your private key for signing

Returns: Redirect URL string

getPaymentStatus(string $statusUrl, string $clientId, string $privateKey): array

Retrieves the current status of a payment.

Parameters:

• $statusUrl - Status URL from payment initiation response
• $clientId - Your Swedbank client ID
• $privateKey - Your private key for signing

Returns: Payment status array

getPaymentInitiationForm(string $bic, array $paymentData, string $clientId, string $privateKey): array

Gets payment initiation form data for a specific provider.

Parameters:

• $bic - Bank Identifier Code
• $paymentData - Payment data array
• $clientId - Your Swedbank client ID
• $privateKey - Your private key for signing

Returns: Form data array

EveryPay integration

This package also includes a lightweight integration with the EveryPay Payment Integration API v4 (see the official docs at https://support.every-pay.com/apidoc/main/ and the OpenAPI spec at https://support.every-pay.com/apidoc/main/openapi.yaml).

Configuration

After publishing the config (php artisan vendor:publish --tag=swedbank-config), you will also get an everypay.php config file:

Example .env for demo:

Basic usage

The EveryPay client is exposed as LimeTools\Swedbank\EveryPayApi and is bound in the container, so you can type‑hint it:

You can also resolve the client manually:

EveryPayApi methods

• **createOneOffPayment(array $payload): array**: wraps POST /v4/payments/oneoff.
  • Required fields (either provided explicitly or filled from config): account_name, amount, api_username, customer_url, nonce, order_reference, timestamp.
  • Returns the decoded JSON response (including payment_link and payment_methods).
• **getPaymentStatus(string $paymentReference): array**: wraps GET /v4/payments/{payment_reference}.
  • Returns the decoded payment status response so you can inspect payment_state, processing_error, ob_details, etc.

Logging

The package supports comprehensive logging. Configure logging in your config/swedbank.php:

Make sure to add the swedbank channel to your config/logging.php:

Testing

To test the package, you can use Swedbank's sandbox environment:

1. Set SWEDBANK_ENVIRONMENT=sandbox in your .env
2. Configure sandbox credentials
3. Use the sandbox endpoints for testing

Error Handling

The package throws exceptions when API calls fail. Always wrap API calls in try-catch blocks:

Security

• Always store private keys securely (use environment variables)
• Never commit private keys to version control
• Use HTTPS for all redirect URLs
• Validate and sanitize all user input
• Follow Swedbank's security best practices

Support

For issues, questions, or contributions, please visit the GitHub repository.

License

This package is open-sourced software licensed under the MIT license.

Credits

This package is based on the official Swedbank Payment Initiation API V3 documentation.

Changelog

1.0.0

• Initial release
• Swedbank Payment Initiation API V3 support
• JWS authentication
• Payment provider management
• Payment status checking