Adyen APIs Library for Python

This is the officially supported Python library for using Adyen's APIs.

Supported API versions

API	Description	Service Name	Supported version
BIN lookup API	The BIN Lookup API provides endpoints for retrieving information based on a given BIN.	binLookup	v52
Balance Platform API	The Balance Platform API enables you to create a platform where you can onboard your users as account holders and create balance accounts, cards, and business accounts.	balancePlatform	v2
Checkout API	Our latest integration for accepting online payments.	checkout	v70
Data Protection API	Endpoint for requesting data erasure.	dataProtection	v1
Legal Entity Management API	Endpoint to manage legal entities	legalEntityManagement	v2
Management API	Configure and manage your Adyen company and merchant accounts, stores, and payment terminals.	management	v1
Payments API	Our classic integration for online payments.	payments	v68
Payouts API	Endpoints for sending funds to your customers.	payouts	v68
POS Terminal Management API	Endpoints for managing your point-of-sale payment terminals.	terminal	v1
Recurring API	Endpoints for managing saved payment details.	recurring	v68
Stored Value API	Endpoints for managing gift cards.	storedValue	v46
Transfers API	Endpoints for managing transfers, getting information about transactions or moving fund	transfers	v3

For more information, refer to our documentation or the API Explorer.

Prerequisites

Adyen test account
API key. For testing, your API credential needs to have the API PCI Payments role.
Python 3.6
Packages (optional): requests or pycurl

Installation

For development purposes

Clone this repository and run

make install

For usage propose

Use pip command:

pip install Adyen

Using the library

General use with API key

import Adyen

adyen = Adyen.Adyen()

adyen.payment.client.xapikey = "YourXapikey"
adyen.payment.client.hmac = "YourHMACkey"
adyen.payment.client.platform = "test" # Environment to use the library in.
adyen.payment.client.merchant_account = "merchant account name from CA"

Consuming Services

Every API the library supports is represented by a service object. The name of the service matching the corresponding API is listed in the Integrations section of this document.

Using all services

import Adyen
adyen = Adyen.Adyen()
adyen.payment.client.xapikey = "YourXapikey"
adyen.payment.client.platform = "test"  # change to live for production
request = {
      "amount": {
        "currency": "USD",
        "value": 1000 # value in minor units
      },
      "reference": "Your order number",
      "paymentMethod": {
        "type": "visa",
        "encryptedCardNumber": "test_4111111111111111",
        "encryptedExpiryMonth": "test_03",
        "encryptedExpiryYear": "test_2030",
        "encryptedSecurityCode": "test_737"
      },
      "shopperReference": "YOUR_UNIQUE_SHOPPER_ID_IOfW3k9G2PvXFu2j",
      "returnUrl": "https://your-company.com/...",
      "merchantAccount": "YOUR_MERCHANT_ACCOUNT"
    }
result = adyen.checkout.payments_api.payments(request)

Using one of the services

from Adyen import checkout
checkout.client.xapikey = "YourXapikey"
checkout.client.platform = "test"  # change to live for production
request = {
      "amount": {
        "currency": "USD",
        "value": 1000 # value in minor units
      },
      "reference": "Your order number",
      "paymentMethod": {
        "type": "visa",
        "encryptedCardNumber": "test_4111111111111111",
        "encryptedExpiryMonth": "test_03",
        "encryptedExpiryYear": "test_2030",
        "encryptedSecurityCode": "test_737"
      },
      "shopperReference": "YOUR_UNIQUE_SHOPPER_ID_IOfW3k9G2PvXFu2j",
      "returnUrl": "https://your-company.com/...",
      "merchantAccount": "YOUR_MERCHANT_ACCOUNT"
    }
result = checkout.payments_api.payments(request)

Force HTTP library

import Adyen
adyen = Adyen.Adyen()
adyen.client.http_force = 'requests' # or 'pycurl'

Using query parameters (management API only)

Define a dictionary with query parameters that you want to use.

query_parameters = {
   'pageSize':10,
   'pageNumber':3
 }

pass the dictionary to the method as an additional argument.

adyen.management.account_company_level_api.get_companies(query_parameters=query_parameters)

Handling exceptions

Adyen service exceptions extend the AdyenError class. After you catch this exception, you can access the class arguments for the specifics around this error or use the debug method which prints all the arguments.

try:
    adyen.checkout.payments(request)
except Adyen.exceptions.AdyenErorr as error:
    error.debug()

List of exceptions

AdyenInvalidRequestError

AdyenAPIResponseError

AdyenAPIAuthenticationError

AdyenAPIInvalidPermission

AdyenAPICommunicationError

AdyenAPIValidationError

AdyenAPIUnprocessableEntity

AdyenAPIInvalidFormat

AdyenEndpointInvalidFormat

Example integration

For a closer look at how our Python library works, clone our example integration. This includes commented code, highlighting key features and concepts, and examples of API calls that can be made using the library.

Contributing

We encourage you to contribute to this repository, so everyone can benefit from new features, bug fixes, and any other improvements.

Have a look at our contributing guidelines to find out how to raise a pull request.

Support

If you have a feature request, or spotted a bug or a technical problem, create an issue here.

For other questions, contact our Support Team.

Licence

This repository is available under the MIT license.

mgu/adyen-python-api-library