PyRevolut: A Revolut Business API Wrapper

pyrevolut is an un-official wrapper around the Revolut Business API.

Installation

pip install pyrevolut

Usage

Basic Usage

from pyrevolut.client import Client

CREDS_JSON_LOC = "path/to/creds.json"

client = Client(
    creds_loc=CREDS_JSON_LOC,
    sandbox=True,
)

# Initialize the client
client.open()

# List all accounts for the authenticated user
accounts = client.Accounts.get_all_accounts()

# Close the client
client.close()

# You can also use the client as a context manager
with Client(
    creds_loc=CREDS_JSON_LOC,
    sandbox=True
) as client:
    accounts = client.Accounts.get_all_accounts()

Advanced Usage

It is possible to use the client library asynchronously by using the AsyncClient object.

import asyncio
from pyrevolut.client import AsyncClient

CREDS_JSON_LOC = "path/to/creds.json"

client = AsyncClient(
    creds_loc=CREDS_JSON_LOC,
    sandbox=True,
)

# Run without context manager
async def run():
    await client.open() 
    accounts = await client.Accounts.get_all_accounts()
    await client.close() 
    return accounts

# Run with context manager
async def run_context_manager():
    async with client:
        accounts = await client.Accounts.get_all_accounts() 
    return accounts

# List all accounts for the authenticated user
accounts = asyncio.run(run())
accounts_context_manager = asyncio.run(run_context_manager())

Authentication

In order to make use of the Revolut Business API, you will need to go through several steps to authenticate your application. The basic guide can be found here. We have provided a simple CLI tool to help you generate the necessary credentials. This tool follows the steps outlined in the guide.

pyrevolut auth-manual

or equivalently

python -m pyrevolut auth-manual

Upon completion, you will have a .json file that you can use to authenticate your application.

Alternatively, in the event that you already have all your credential information stored, you can simply create a .json file with the following structure:

{
    "certificate": {
        "public": "public-certificate-base64-encoded",
        "private": "private-key-base64-encoded",
        "expiration_dt": "2500-01-01T00:00:00Z"
    },
    "client_assert_jwt": {
        "jwt": "client-assertion-jwt",
        "expiration_dt": "2500-01-01T00:00:00Z"
    },
    "tokens": {
        "access_token": "access-token",
        "refresh_token": "refresh-token",
        "token_type": "bearer",
        "access_token_expiration_dt": "2020-01-01T17:22:42.934699Z",
        "refresh_token_expiration_dt": "2500-01-01T00:00:00Z"
    }
}

API Support Status

The wrapper currently supports the following APIs:

• Accounts
  • Retrieve all accounts
  • Retrieve an account
  • Retrieve account's full bank details
• Cards (Live only)
  • Retrieve a list of cards
  • Create a card
  • Retrieve card details
  • Update card details
  • Terminate a card
  • Freeze a card
  • Unfreeze a card
  • Retrieve sensitive card details
• Counterparties
  • Retrieve a list of counterparties
  • Retrieve a counterparty
  • Delete a counterparty
  • Create a counterparty (Personal)
  • Create a counterparty (Business)
  • Validate an account name (CoP)
• Foreign exchange
  • Get an exchange rate
  • Exchange money
• Payment drafts
  • Retrieve all payments drafts
  • Create a payment draft
  • Retrieve a payment draft
  • Delete a payment draft
• Payout links
  • Retrieve a list of payout links
  • Retrieve a payout link
  • Create a payout link
  • Cancel a payout link
• Simulations (Sandbox only)
  • Simulate a transfer state update
  • Simulate an account top-up
• Team members (Live only)
  • Retrieve a list of team members
  • Invite a new memebr to your business
  • Retrieve team roles
• Transactions
  • Retrieve a list of transactions
  • Retrieve a transaction
• Transfers
  • Move money between your accounts
  • Create a transfer to another account
  • Get transfer reasons
• Webhooks (v2)
  • Create a new webhook
  • Retrieve a list of webhooks
  • Retrieve a webhook
  • Update a webhook
  • Delete a webhook
  • Rotate a webhook signing secret
  • Retrieve a list of failed webhook events
  • Verify a webhook signature

Contributing

In order to facilitate a streamlined development process, we have a few guidelines that we would like to follow. Please refer to the CONTRIBUTING.md file for more information.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Disclaimer: pyrevolut is an un-official API wrapper. It is in no way endorsed by or affiliated with Revolut or any associated organization. Make sure to read and understand the terms of service of the underlying API before using this package. The authors accept no responsiblity for any damage that might stem from use of this package.