Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Welcome to FasterPay Python SDK

FasterPay Python SDK enables you to integrate the FasterPay's Checkout Page seamlessly without having the hassle of integrating everything from Scratch. Once your customer is ready to pay, FasterPay will take care of the payment, notify your system about the payment and return the customer back to your Thank You page.

Downloading the FasterPay Python SDK

$ git clone

Installing the FasterPay Python SDK.

$ cd fasterpay-Python
$ sudo python install

Initiating Payment Request using Python SDK

from fasterpay.gateway import Gateway

if __name__ == "__main__":

  gateway = Gateway("<your private key>", "<your public key>", True)

  parameters = {
        "payload": {
            "description": "Golden Ticket",
            "amount": "0.01",
            "currency": "EUR",
            "merchant_order_id": str(random.randint(1000, 9999)),
            "success_url": "",
            "sign_version": "v2",
            "pingback_url": "",

  paymentForm = gateway.payment_form().build_form(parameters)
  print paymentForm

For more information on the API Parameters, refer to our entire API Documentation here

Handling FasterPay Pingbacks

from flask import request
from fasterpay.gateway import FP_Gateway
gateway = Gateway("<your private key>", "<your public key>", True)
pingback_data = request.get_data()
if request.headers.get("X-Fasterpay-Signature-Version") == "v2":
    headers = {
        "X-Fasterpay-Signature": str(request.headers.get("X-Fasterpay-Signature")),
        "X-Fasterpay-Signature-Version": str(request.headers.get("X-Fasterpay-Signature-Version"))
    headers = {
        "X-ApiKey": str(request.headers.get("X-ApiKey"))

if gateway.pingback().validate(pingback_data, headers) is True:
    return "OK"
    return "NOK"

FasterPay Test Mode

FasterPay has a Sandbox environment called Test Mode. Test Mode is a virtual testing environment which is an exact replica of the live FasterPay environment. This allows businesses to integrate and test the payment flow without being in the live environment. Businesses can create a FasterPay account, turn on the Test Mode and begin to integrate the widget using the test integration keys.

Initiating FasterPay Gateway in Test-Mode

from fasterpay.gateway import Gateway
gateway = Gateway("<your private key>", "<your public key>", True)