PEGASUS ALFA PLATFORM API

Build with Pegasus Alfa.
Choose only what you need.

One integration surface for direct clients, partners, white-label platforms and global-trade applications. Select the Pegasus Alfa services your programme requires, combine them with scoped API credentials, and integrate customer, account, card, payment and event capabilities without creating a second ledger.

platform-api / v1
# Server-to-server authentication
Authorization: Bearer <clientId>.<apiKey>

# Dynamic service profile
{
  "clientType": "TRADE_PLATFORM",
  "services": [
    "ACCOUNTS",
    "EXTERNAL_PAYMENTS",
    "GLOBAL_TRADE_METADATA",
    "WEBHOOKS"
  ]
}
DYNAMIC PRODUCT ENTITLEMENTS

Compose the API around the partner.

Services define which Pegasus Alfa products are enabled for the client. API scopes separately define what each credential may do inside those products. Dependencies are resolved automatically.

CUSTOMER_MANAGEMENT

Customer Management

Provision managed personal or business customers and retrieve onboarding / KYC status.

ACCOUNTS

Multi-Currency Accounts

Read linked Pegasus Alfa accounts, balances, account status and provider-safe account metadata.

CARDS

Cards

Read card status, form factor, last four digits, expiry and customer card controls.

PAYMENT_HISTORY

Payment History

Retrieve payment history, review state, risk status and settlement state.

INTERNAL_PAYMENTS

Internal Payments

Submit controlled Pegasus Alfa-to-Pegasus Alfa payment instructions.

EXTERNAL_PAYMENTS

External Payments

Submit controlled external payment instructions over enabled rails.

GLOBAL_TRADE_METADATA

Global Trade References

Attach trade, invoice, purchase-order and shipment references for reconciliation.

WEBHOOKS

Signed Webhooks

Receive signed, retrying customer and payment events.

Partner / Client App
Partner Backend
Pegasus Alfa Platform API
Accounts · Cards · Payments · Controls
INTERACTIVE SANDBOX

Test the integration model before credentials.

This browser sandbox is intentionally isolated from production and never moves funds. Toggle services to see how dynamic entitlements affect API requests, run representative calls and copy server-side request examples.

API Explorer

Platform API v1 · isolated sample environment
SANDBOX READY
200 Sandbox response
Security model: real Pegasus Alfa API credentials are server-to-server secrets and must never be entered into this public page, browser JavaScript or a mobile bundle. Approved partners receive credentials separately and use the same documented request structure from their backend.
INTEGRATION BASICS

Designed for embedded and white-label delivery.

AUTHENTICATION

Dedicated platform credentials

Each approved integration receives an isolated client identity, scopes, service entitlements, optional IP/origin restrictions and its own rate limit.

Authorization: Bearer <clientId>.<apiKey>
BASE PATH

Versioned API surface

Integrations use the Pegasus Alfa Platform API v1 surface. The assigned API host is provided with sandbox or production credentials.

/api/platform/v1
PAYMENT SAFETY

Existing controls remain authoritative

API-originated payment instructions retain Pegasus Alfa onboarding, KYC, risk, limits, idempotency and controlled-review requirements.

Idempotency-Key: partner-request-001
GLOBAL TRADE

Reconciliation-ready metadata

Trade platforms can attach trade, invoice, purchase-order and shipment references when the Global Trade service is enabled.

tradeReference · invoiceReference · purchaseOrderReference · shipmentReference
WEBHOOKS

Signed events with retries

Customer and payment events can be delivered to approved HTTPS endpoints with HMAC-SHA256 signatures and retry handling.

X-Pegasus-Signature: sha256=<hmac>
SERVICE REQUESTS

Partners choose; Pegasus Alfa approves

A partner may request a different service mix without changing API credentials. Sensitive capabilities become active only after Pegasus Alfa approval.

POST /api/platform/v1/services/requests

Ready to connect your platform?

Tell us whether you are integrating as a direct client, partner, white-label programme or global-trade platform, and which Pegasus Alfa services you want to test.

Request API sandbox access