Logo
Home Products Solutions Developers Contact
Developer Portal

The API for
global finance.

Designed by developers, for developers. Predictable RESTful architecture, typed SDKs, strict versioning, and zero breaking changes.

create_payment.js
// 1. Install the Aegis Node.js SDK
$ npm install @aegis/node
// 2. Initialize with your secret key
import { Aegis } from '@aegis/node';
const aegis = new Aegis('sk_live_28xA...');

// 3. Create a Payment Intent
const intent = await aegis.paymentIntents.create({
amount: 250000, // $2,500.00
currency: 'usd',
automatic_payment_methods: { enabled: true },
receipt_email: 'alex@example.com',
});

console.log(`Payment initialized: ${intent.id}`);

Official Libraries & SDKs

Node.js

v14.0 or higher

npm i @aegis/node

PHP

PHP 8.0 / Laravel 10

composer req aegis/php

Python

Django & Flask

pip install aegis-api

Go

High Concurrency

go get github.com/aegis

Documentation

Interactive API Reference

Authentication

The Aegis API uses API keys to authenticate requests. You can view and manage your API keys in the Aegis Dashboard.

Your API keys carry many privileges, so be sure to keep them secure! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, and so forth.

Bearer Token

Authentication to the API is performed via HTTP Bearer Auth. Provide your API key as the bearer token value in the Authorization header.

All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.

# Authenticate your API request
curl https://api.aegis.com/v1/charges \
-H "Authorization: Bearer sk_test_4eC39Hq..." \
-d amount=2000 \
-d currency="usd" \
-d source="tok_mastercard"


// Response
{
"id": "ch_3MowQjLkdIw",
"object": "charge",
"amount": 2000,
"currency": "usd",
"status": "succeeded"
}

Idempotency

Network issues happen. The Aegis API supports idempotency for safely retrying requests without accidentally performing the same operation twice.

curl https://api.aegis.com/v1/charges \
  -H "Idempotency-Key: a1b2c3d4" \
  -d amount=2000

Webhooks

Aegis can send webhook events that notify your application any time an event happens on your account, keeping your database perfectly synced.

app.post('/webhook', (req, res) => {
  const event = req.body;
  if (event.type === 'payment_intent.succeeded') {
    fulfillOrder();
  }
});
bash
~ aegis login
Please press Enter to open your browser and authorize the CLI.
✓ Authentication successful.
~ aegis listen --forward-to localhost:3000/webhook
Ready! Waiting for requests...
2026-03-11 10:14:22 | 200 OK | payment_intent.succeeded
2026-03-11 10:15:05 | 200 OK | customer.created
Developer Tools

Build and test locally.

The Aegis CLI lets you build, test, and manage your integration directly from the terminal. Stream real-time API logs and forward webhooks to your local server instantly.

  • Trigger Mock Events Simulate payments, refunds, and disputes without touching the dashboard.
  • Tail API Logs Monitor API requests and responses in real-time as your app makes them.
npm i -g aegis-cli

Engineered for five nines.

Our infrastructure is globally distributed, highly available, and compliant with the strictest financial security standards. We handle the complexity so you can focus on building.

99.999%

Historical Uptime

Zero planned downtime. We utilize multi-region active-active clusters to ensure your payments never fail.

< 150ms

API Latency

Requests are routed to the nearest geographic edge node, guaranteeing lightning-fast authorization rates.

Level 1

PCI-DSS Compliant

Aegis is a certified PCI Level 1 Service Provider. We tokenize and encrypt sensitive data at rest and in transit.

Integration Guides

Start with a template.

Clone our open-source sample applications to understand best practices and accelerate your time to market.

Evolving without breaking.

We introduce new features and improvements constantly, but we guarantee backwards compatibility. Your API version is pinned to the date you created your account.

Read our versioning policy
2026-03-01

Idempotency support for Issuing API

You can now safely retry physical and virtual card creation requests by passing the Idempotency-Key header.

2026-02-15

New Webhook Event types

Added dispute.created and dispute.won event types to help automate chargeback management.

2026-01-20

Enhanced Error Codes

Card decline errors now include more granular `decline_code` attributes, such as `insufficient_funds` or `try_again_later`.

Join the developer ecosystem

Get help from our engineering team, share your projects, and connect with thousands of other developers building the future of money.

Ready to execute?

Get your API keys and make your first successful API call in under 3 minutes.

Got Questions?

Frequently Asked Questions

Most teams can complete a basic integration in their sandbox environment within a single afternoon. Full production deployment, including testing and business verification, typically takes 1-2 weeks depending on your use case.

Aegis currently supports direct bank payouts to over 135 countries and 50+ local currencies. We automatically handle FX conversions at competitive mid-market rates.

Our standard plan is strictly pay-as-you-go with no hidden monthly fees. You only pay a small percentage per successful transaction. For enterprise volume, we offer customized subscription tiers with lower transaction rates.

Yes! Our sandbox environment is a 1:1 replica of our production systems. You can simulate test cards, force specific error codes, and trigger webhooks exactly as they would behave in the real world.