revolut

# Revolut Business API

Full CLI for **Revolut Business** — accounts, transactions, payments, FX, exports.

**Entry point:** `python3 {baseDir}/scripts/revolut.py`

## Setup

### Interactive Setup Wizard (recommended)
```bash
python3 {baseDir}/scripts/setup.py
```
Walks you through everything: key generation, Revolut certificate upload, OAuth callback, authorization.

### Manual Setup
- Python 3.10+, `pip install PyJWT cryptography`
- Revolut Business account with API certificate
- See [README](https://github.com/christianhaberl/revolut-openclaw-skill) for detailed step-by-step guide

### Credentials
Stored in `~/.clawdbot/revolut/`:
- `private.pem` — RSA private key (for JWT signing)
- `certificate.pem` — X509 cert (uploaded to Revolut)
- `tokens.json` — OAuth tokens (auto-managed)
- `config.json` — client ID, domain, redirect URI

Environment variables (in `.env`):
- `REVOLUT_CLIENT_ID` — from Revolut API settings
- `REVOLUT_ISS_DOMAIN` — your redirect URI domain (without https://)

## Commands

### Accounts & Balances
```bash
python3 {baseDir}/scripts/revolut.py accounts          # List all accounts with balances
python3 {baseDir}/scripts/revolut.py balance            # Total EUR balance
python3 {baseDir}/scripts/revolut.py accounts --json    # JSON output
```

### Transactions
```bash
python3 {baseDir}/scripts/revolut.py transactions                    # Last 20
python3 {baseDir}/scripts/revolut.py tx -n 50                       # Last 50
python3 {baseDir}/scripts/revolut.py tx --since 2026-01-01           # Since date
python3 {baseDir}/scripts/revolut.py tx --since 2026-01-01 --to 2026-01-31
python3 {baseDir}/scripts/revolut.py tx -a Main                     # Filter by account
python3 {baseDir}/scripts/revolut.py tx --type card_payment          # Filter by type
python3 {baseDir}/scripts/revolut.py tx --json                      # JSON output
```

Transaction types: `card_payment`, `transfer`, `exchange`, `topup`, `atm`, `fee`, `refund`

### Counterparties
```b...

# Revolut Business API — OpenClaw Skill

Full CLI for **Revolut Business** — accounts, balances, transactions, counterparties, payments, FX exchange, CSV export.

> ⚠️ **Business only** — Revolut Personal API requires PSD2 Open Banking (AISP) registration and is not supported.

## Features

- 💰 **Accounts & Balances** — list all accounts, total EUR balance
- 📋 **Transactions** — filter by date, type, account; JSON output
- 👥 **Counterparties** — list, search by name
- 💸 **Payments** — send payments (with confirmation) or create drafts
- 💱 **FX Exchange** — exchange currencies between accounts
- 🔄 **Internal Transfers** — move funds between own accounts
- 📊 **CSV Export** — export transactions for bookkeeping
- 🔑 **Auto Token Refresh** — OAuth tokens refresh automatically via JWT

## Setup (Step by Step)

### Prerequisites
- Python 3.10+
- `pip install PyJWT cryptography`
- A **Revolut Business** account (not personal!)
- A domain you control (for OAuth redirect URI)

---

### Step 1: Generate RSA Key Pair & X509 Certificate

```bash
mkdir -p ~/.clawdbot/revolut
cd ~/.clawdbot/revolut

# Generate private key
openssl genrsa -out private.pem 2048

# Generate X509 certificate (Revolut requires this format, NOT just a public key!)
openssl req -new -x509 -key private.pem -out certificate.pem -days 730 -subj "/CN=openclaw/O=YourCompany/C=AT"
```

> ⚠️ Revolut **rejects** a plain public key — you must upload an **X509 certificate**.

---

### Step 2: Set Up OAuth Callback URL

Revolut needs a real HTTPS URL to redirect to after authorization. You have two options:

#### Option A: Cloudflare Worker (recommended, free)

If you have a domain on Cloudflare, create a simple worker that displays the auth code:

```javascript
addEventListener("fetch", event => {
  event.respondWith(handleRequest(event.request))
})

async function handleRequest(request) {
  const url = new URL(request.url)
  const code = url.searchParams.get("code")
  if (code) {
    return new Response(`<h...