CLI

CLI argentive-admin

El CLI B2B es la herramienta para plataformas que emiten tarjetas a sus usuarios finales. Wrapper sobre la REST API con keys sk_test_ / sk_live_, autocompletado y helpers para webhooks.

Instalación

terminal
npm install -g @argentive/admin

argentive-admin --version
# argentive-admin 0.1.0

Setup inicial

Apuntá el CLI a tu key. Por defecto guarda la config en ~/.argentive-admin/config.json.

terminal
argentive-admin config set api_key sk_test_4242abc...
argentive-admin config set environment test    # test | live

# verificar
argentive-admin config show

O por env var (recomendado en CI):

.env
ARGENTIVE_API_KEY=sk_test_...
ARGENTIVE_API_BASE=https://api.argentive.card

Cardholders

terminal
# Crear cardholder
argentive-admin cardholders create \
  --first-name Ada --last-name Lovelace \
  --dob 1990-03-15 --phone +5491150000000 \
  --tax-id 20-12345678-9 --country AR

# Listar
argentive-admin cardholders list --limit 50

# Get
argentive-admin cardholders get ch_01HW3FN4Y8...

# Update
argentive-admin cardholders update ch_01HW3FN4Y8... --email ada@new.com

# Onboarding hosted
argentive-admin cardholders onboard \
  --return-url https://miapp.com/onboarding/done \
  --email ada@argentive.ai

Cards

terminal
# Crear card
argentive-admin cards create \
  --cardholder ch_01HW3FN4Y8... \
  --amount 2500 \
  --currency USD \
  --idempotency-key "my-app-card-01HW3..."

# Listar (filtros)
argentive-admin cards list \
  --status OPEN \
  --cardholder ch_01HW3FN4Y8... \
  --limit 25

# Detalles sensibles (auditado)
argentive-admin cards details card_01HW3FNE2R... \
  --reason "manual support escalation"

# Cerrar (libera hold)
argentive-admin cards close card_01HW3FNE2R...

Webhooks

argentive-admin listen

Tunelea los webhooks de Argentive a tu localhost. Equivalente al stripe listen de Stripe — clave para desarrollo local.

terminal
argentive-admin listen --forward-to http://localhost:3000/api/webhooks/argentive

✓ Conectado. Webhook secret de sesión: whsec_test_01HW3...
✓ Reenviando eventos a http://localhost:3000/api/webhooks/argentive

2026-06-24 11:48:23  evt_01HW...  transaction.authorized   →  200 (43ms)
2026-06-24 11:49:01  evt_01HW...  transaction.cleared      →  200 (28ms)
2026-06-24 11:53:11  evt_01HW...  card.closed              →  200 (35ms)

argentive-admin trigger

Dispará un evento de prueba para validar tu handler:

terminal
argentive-admin trigger transaction.cleared --card card_01HW3FNE2R...
argentive-admin trigger card.closed
argentive-admin trigger balance.low
argentive-admin trigger cardholder_onboarding_session.completed

argentive-admin webhook-endpoints

terminal
# Crear endpoint productivo
argentive-admin webhook-endpoints create \
  --url https://miapp.com/api/webhooks/argentive \
  --events "card.*,transaction.*"

# Listar
argentive-admin webhook-endpoints list

# Rotar secret
argentive-admin webhook-endpoints roll-secret whe_01HW3...

# Eliminar
argentive-admin webhook-endpoints delete whe_01HW3...

Gestión de API keys

terminal
argentive-admin api-keys list

argentive-admin api-keys create --label "CI/CD test" --mode test
# Devuelve la key una sola vez — guardala en tu vault.

argentive-admin api-keys rotate ak_01HW3...     # invalida en 24h
argentive-admin api-keys revoke ak_01HW3...     # invalida ahora

Logs y debugging

terminal
# Últimos 50 requests a tu API key
argentive-admin logs list --limit 50

# Detalle de un request (full request/response, headers)
argentive-admin logs get req_01HW3...

# Errores recientes
argentive-admin logs list --status 4xx,5xx --since 1h
Modo --json
Cualquier comando acepta --json para output programable. Combinable con jq en scripts:
terminal
argentive-admin cards list --status OPEN --json \
  | jq -r '.[] | select(.balanceCents > 5000) | .id'

Autocomplete

terminal
# bash
argentive-admin completion bash > /etc/bash_completion.d/argentive-admin

# zsh
argentive-admin completion zsh > /usr/local/share/zsh/site-functions/_argentive-admin

# fish
argentive-admin completion fish > ~/.config/fish/completions/argentive-admin.fish