{ } API

Emití tarjetas para tus agentes por API.

Card issuing programático para plataformas y agentes. Autenticá con un token y operá cuentas, tarjetas, permisos y autorizaciones. Los montos van en centavos.

bash

curl https://cardia-api.emipanelli.com/admin/cards \
  -H "x-admin-token: $CARDIA_API_TOKEN"

Base: https://cardia-api.emipanelli.com · Autenticá cada request con el header x-admin-token.

bash

$ curl -X POST https://cardia-api.emipanelli.com/admin/cards \

-H "x-admin-token: $CARDIA_API_TOKEN" \

-H "Content-Type: application/json" \

-d '{ "currency": "USD", "mode": "scoped" }'

HTTP/1.1 201 Created

{

"id": "card_02",

"currency": "USD",

"mode": "scoped",

"last4": "8841",

"balanceCents": 0

} ▋

Endpoints

Cuentas

GET/admin/accounts

Lista las cuentas. Cada una incluye balances { ARS, USD } en centavos.

POST/admin/accounts/:id/cash-in

Acredita saldo. Body: { amountCents, currency, idempotencyKey }.

POST/admin/accounts/:id/cash-out

Debita saldo. Body: { amountCents, currency, idempotencyKey }.

POST/admin/accounts/:id/exchange

Convierte entre saldos. Body: { fromCurrency, toCurrency, amountCents }.

Tarjetas

GET/admin/cards

Lista las tarjetas, con currency 'ARS'|'USD' y mode 'free'|'scoped'.

POST/admin/cards

Emite tarjetas. Sin accountId crea cuenta + 2 tarjetas (ARS y USD).

PATCH/admin/cards/:id/mode

Cambia el modo. Body: { mode: 'free'|'scoped' }.

Permisos

GET/admin/permissions

Lista permisos. Filtrá con ?cardId=.

POST/admin/permissions

Crea un permiso. Body: { cardId, merchant, maxAmountCents, ttlSeconds }.

POST/admin/permissions/:id/cancel

Cancela un permiso vigente.

Autorizaciones

POST/admin/authorizations/simulate

Simula una compra. Body: { cardId, merchant, amountCents } → { status, reason }.

GET/admin/authorizations

Lista las transacciones (autorizaciones).

Ejemplo: simular una autorización

bash

$ curl -X POST https://cardia-api.emipanelli.com/admin/authorizations/simulate \

-H "x-admin-token: $CARDIA_API_TOKEN" \

-H "Content-Type: application/json" \

-d '{ "cardId": "card_01", "merchant": "Jumbo", "amountCents": 1200000 }'

response

{

"status": "APPROVED",

"reason": "permiso vigente · Jumbo · ≤ $50.000"

}

CLI→MCP→Docs→

¿Listo para darle una tarjeta a tu agente?

Sumate a la lista de espera y probá el authorizer en vivo en la demo.

Sumate →Probar la demo