Skip to main content
Accept regulated stablecoin payments from your website or application. Your customers pay with stablecoins (USDC, EURe), you get instant settlement to your wallet: no intermediaries, no chargebacks.
What are stablecoins? Digital currencies pegged 1:1 to real money (USDC = US Dollar, EURe = Euro). Payments settle on the blockchain in seconds: no bank transfers, no chargebacks, no hold periods.

​
Why AgentaOS Payments?

Stripe-like DX

npm install @agentaos/pay then create checkouts in 5 lines of code. TypeScript types for everything.

No crypto knowledge

Your backend creates a checkout, we handle wallets, chains, and settlement. You get a webhook when paid.

Instant settlement

Payments settle on-chain in seconds. No hold periods, no chargebacks, no currency conversion delays.

​
What You Get

FeatureDescription
CheckoutsCreate payment sessions with amount, currency, buyer info, tax rate
Payment LinksReusable shareable URLs for recurring payments
WebhooksReal-time checkout.session.completed events with HMAC signatures
InvoicesAuto-generated EU-compliant invoices with exchange rates and VAT
Monthly StatementsWise-style PDF with balance reconciliation and VAT summary
CSV Export22-column export for accounting software (Merit, Directo, Xero)
Unified TransactionsSingle ledger for all inbound + outbound payments
Multi-tokenAccept USDC, EURe, EURC, WETH, DAI - settled to your preferred stablecoin

​
Quick Start

1

Install the SDK

npm install @agentaos/pay
2

Get your API key

Go to app.agentaos.ai → Developer → API Keys → Create Key
3

Create a checkout

import { AgentaOS } from '@agentaos/pay';

const agentaos = new AgentaOS(process.env.AGENTAOS_API_KEY!);

const checkout = await agentaos.checkouts.create({
  amount: 49.99,
  currency: 'EUR',
  description: 'Pro Plan - Monthly',
  successUrl: 'https://myshop.com/success',
  webhookUrl: 'https://myshop.com/webhooks',
});

console.log(checkout.checkoutUrl);
// → https://app.agentaos.ai/checkout/mZrESFyR7RC9RPsJfZCVkg
4

Handle the webhook

app.post('/webhooks', express.raw({ type: 'application/json' }), (req, res) => {
  const event = agentaos.webhooks.verify(
    req.body,
    req.headers['x-agentaos-signature'],
    process.env.AGENTAOS_WEBHOOK_SECRET!,
  );

  if (event.type === 'checkout.session.completed') {
    fulfillOrder(event.data.sessionId);
  }

  res.sendStatus(200);
});

​
Integration Path

1

Get credentials (2 min)

Create an API key and reveal your webhook secret in Developer settings.
2

Create your first checkout (5 min)

Follow the SDK overview to create a checkout and get a payment URL.
3

Handle webhooks (5 min)

Set up a webhook handler to know when payments are confirmed.
4

Test end-to-end (10 min)

Run the Express shop example to see the full flow working.
5

Add invoicing (optional, 3 min)

Configure tax rates and exports for EU compliance.

​
Supported Currencies

CurrencyTokenNetwork
EUREURe (Monerium)Base
EUREURC (Circle)Base
USDUSDC (Circle)Base
USDUSDT (Tether)Base
-WETHBase
-DAIBase
More networks coming soon. Currently supporting Base mainnet and Base Sepolia (testnet).

​
REST API

Don’t use TypeScript? The SDK wraps a standard REST API. Use it from any language: 
curl -X POST https://api.agentaos.ai/api/v1/gateway/sessions \
  -H "x-api-key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 49.99,
    "currency": "EUR",
    "description": "Pro Plan",
    "successUrl": "https://myshop.com/success",
    "webhookUrl": "https://myshop.com/webhooks"
  }'
See the API Reference for all endpoints.