For Developers

The payment API
agents already trust.

One REST API across card, ACH, SEPA, x402, and stablecoin rails. TypeScript SDK, idempotent payments, HMAC-signed webhooks, delegated-custody signing. Under five minutes from `npm install` to first paid request.

Quick start

Five lines to a working agent payment.

Install the SDK, drop in your API key, send a payment. Same call works against the mock provider in tests and the live providers in production.

TypeScript
import { Arispay } from '@arispay/sdk';

const arispay = new Arispay({ apiKey: process.env.ARISPAY_API_KEY });

const payment = await arispay.payments.create({
  amount: 99.99,
  currency: 'USD',
  rail: 'card',
  agentId: 'agent_123',
});

Two SDKs. One platform.

For agent builders

PayAgent

Agent-side x402 SDK. Wrap any fetch call with payFetchDelegated() and pay HTTP 402 challenges automatically. Vercel AI SDK + LangChain adapters included.

For merchants

PayGate

Server-side middleware. Drop paygateExpress() or paygateFastify() on any route to gate it behind a price. Settlement runs on Base mainnet through our hosted facilitator.

Built like you'd build it.

The boring stuff is done. Spend the time on the agent, not the payments plumbing.

Idempotent by default

Every POST takes an Idempotency-Key. Retry as much as your network does. We dedupe on the server.

HMAC-signed webhooks

Every webhook carries an HMAC-SHA256 signature plus replay-protected timestamp. Verify in one helper call.

Delegated custody

x402 signing runs through Coinbase CDP. The key never touches your servers. Spend caps enforced before the signature.

Five rails, one schema

Card, ACH, SEPA, x402, and USDC respond with the same Payment shape. Switch rails by changing one field.

Mock + live providers

PAYMENT_PROVIDER=mock for tests, PAYMENT_PROVIDER=fiserv for prod. Same SDK, same response shape.

Stable error codes

Errors are strings, not HTTP statuses. SPEND_LIMIT_EXCEEDED, X402_PAYMENT_FAILED, CARD_DECLINED. Switch on them.

Everything you need.

API reference

Every endpoint, every parameter, every error.

SDK download

TypeScript + Python coming soon. npm-published, semver-stable.

Webhook guide

Event catalog, signature verification, retry semantics.

x402 protocol

How the HTTP 402 payment standard works under the hood.

Get your first paid request before this coffee gets cold.

Sign up, mint an API key, copy the snippet above. Real sandbox, real test wallet, real settlement on Base Sepolia.

Payment API for AI Agents | Arispay Developer Docs