django-payments-saferpay

A Django Payments plugin that integrates Saferpay payment provider with Django Payments.

Features

• Easy integration with Django Payments framework
• Support for Saferpay payment processing
• Sandbox mode for testing
• Simple configuration

Installation

pip install django-payments-saferpay

Configuration

Basic Setup

Add the Saferpay payment variant to your Django settings:

PAYMENT_VARIANTS = {
    "saferpay": (
        "django_payments_saferpay.provider.SaferpayProvider",
        {
            "customer_id": "your-customer-id",
            "terminal_id": "your-terminal-id",
            "username": "your-username",
            "password": "your-password",
            "sandbox": True,  # Set to True for testing, False for production
        }
    )
}

Configuration Options

Environment Variables

For security, it's recommended to store sensitive data in environment variables:

import os

PAYMENT_VARIANTS = {
    "saferpay": (
        "django_payments_saferpay.provider.SaferpayProvider",
        {
            "customer_id": os.environ.get("SAFERPAY_CUSTOMER_ID"),
            "terminal_id": os.environ.get("SAFERPAY_TERMINAL_ID"),
            "username": os.environ.get("SAFERPAY_API_USERNAME"),
            "password": os.environ.get("SAFERPAY_API_PASSWORD"),
            "sandbox": True,
        }
    )
}

Sandbox Testing Environment

The project includes a sandbox application that demonstrates a simple implementation of Django Payments with the SaferPay payment variant. You can use it to:

• See a complete working implementation example
• Test your SaferPay credentials
• Experiment with different payment flows

Setting Up the Sandbox

1. Navigate to the sandbox directory:

   cd sandbox
   

2. Create an environment file (.envrc) with your Saferpay credentials:

   export PAYMENT_HOST=localhost:8000
   export SAFERPAY_CUSTOMER_ID=your-customer-id
   export SAFERPAY_TERMINAL_ID=your-terminal-id
   export SAFERPAY_API_PASSWORD=your-password
   export SAFERPAY_API_USERNAME=API_username_here
   

3. Load the environment variables:

   source .envrc
   

   (Or if you have direnv installed, it will load automatically)

4. Set up and run the sandbox server:

   uv venv                          # Create virtual environment
   source .venv/bin/activate        # Activate virtual environment
   uv pip install ..                # Install the package
   python manage.py migrate         # Set up the database
   python manage.py runserver       # Start the server
   

5. Open your browser and navigate to:

   http://localhost:8000/create-payment/
   

Documentation

For more detailed information, refer to:

• Django Payments Documentation
• Saferpay API Documentation

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

django-payments-saferpay is distributed under the terms of the BSD 3-Clause license.