CASPYAN API

RESTful API pro integraci bankovních služeb do vašich aplikací. Plná kontrola nad účty, platbami a FX operacemi.

API Status: Operational
Version: 2.0
Base URL: api.caspyan.cz/v2

Autentizace

CASPYAN API používá OAuth 2.0 pro autentizaci. Všechny API requesty musí obsahovat Bearer token v hlavičce.

HTTP Header 
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

Získání access tokenu

cURL 
curl -X POST https://api.caspyan.cz/v2/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "your_client_id",
    "client_secret": "your_client_secret",
    "grant_type": "client_credentials"
  }'

Quick Start

Začněte s CASPYAN API ve 3 jednoduchých krocích.

1

Zaregistrujte aplikaci

V nastavení účtu vytvořte novou API aplikaci a získejte client_id a client_secret.

2

Získejte access token

Pomocí OAuth 2.0 flow získejte access token pro autorizaci API volání.

3

Volejte API

S platným tokenem můžete začít volat endpointy pro správu účtů a plateb.

Účty

GET /v2/accounts

Vrátí seznam všech účtů přiřazených k autorizované aplikaci.

Response

JSON 
{
  "accounts": [
    {
      "id": "acc_2xK9mN3pQ",
      "name": "CZK Běžný účet",
      "iban": "CZ65 0100 0000 0027 0123 4567",
      "currency": "CZK",
      "balance": {
        "available": 1523847.50,
        "current": 1525000.00
      },
      "status": "active"
    }
  ],
  "total": 4
}

Platby

POST /v2/payments

Vytvoří novou platbu z vybraného účtu.

Parametry

Parametr Typ Popis
source_account_id* string ID zdrojového účtu
recipient_iban* string IBAN příjemce
amount* number Částka k odeslání
currency* string Měna (ISO 4217)
reference string Reference / VS

Request

cURL 
curl -X POST https://api.caspyan.cz/v2/payments \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "source_account_id": "acc_2xK9mN3pQ",
    "recipient_iban": "CZ55 0100 0000 0012 3456 7890",
    "recipient_name": "ABC Solutions s.r.o.",
    "amount": 50000,
    "currency": "CZK",
    "reference": "2024001234"
  }'

FX Kurzy

GET /v2/fx/rates

Vrátí aktuální směnné kurzy pro dostupné měnové páry.

Response JSON 
{
  "rates": {
    "EUR/CZK": { "bid": 25.15, "ask": 25.35 },
    "USD/CZK": { "bid": 22.85, "ask": 23.05 },
    "GBP/CZK": { "bid": 29.20, "ask": 29.45 },
    "PLN/CZK": { "bid": 5.48, "ask": 5.58 }
  },
  "timestamp": "2026-02-01T14:30:00Z"
}