Guide

Core API basics

Resource, envelope and safety conventions shared by AICardAPI endpoints.

Resources

The MVP contract groups merchant-facing resources around API keys, customers, cardholders, cards, ledger and webhooks. Merchant bootstrap, card programs and provider capability gates remain internal/Ops-controlled.

Envelopes

Successful responses return data with request_id. Errors return error.code, error.message and request_id.

Money fields

Product docs and UI use USD major currency amounts, for example 10000 for $10,000.00. Low-level precision fields remain internal transport details and must not be exposed as operator input labels.