Empezar

Modo de prueba

Toda la API funciona en modo test usando keys sk_test_. Sin mover plata real, sin emitir cards reales en la red del issuer, sin facturar IVA. Pensado para validar tu integración end-to-end en CI/CD.

Cómo activar test mode

Simplemente usá una key que empiece con sk_test_. Todo recurso creado con esa key vive en un namespace separado: no aparece en tus reportes productivos, no suma a tu volumen mensual y no emite recibos AFIP/SAT.

terminal
export ARGENTIVE_KEY="sk_test_4242abc..."

Datos de prueba

Para el flow de payment-method/setup, Mercado Pago y dLocal exponen tarjetas de prueba que Argentive acepta sin hacer hold real. Las tres más comunes:

Tarjetas de prueba
4509 9535 6623 3704
Visa · AR · CVV 123 · 11/30
Aprueba siempre. La autorización pasa.
5031 7557 3453 0604
Mastercard · MX · CVV 123 · 11/30
Aprueba siempre. La autorización pasa.
4774 4517 7203 0027
Visa · AR · CVV 123 · 11/30
Rechaza siempre. Útil para probar el handler de 402.

KYC en test mode

El KYC en sandbox es auto-aprobado cuando usás un taxId que matchea estos patrones:

  • AR taxId empezando con 20- o 27- y dígito verificador válido → aprueba.
  • MX taxId con sufijo TEST en el RFC → aprueba.
  • Cualquier otro caso → queda en estado kyc_review hasta que un operador lo apruebe manualmente desde el dashboard.

Webhooks en test mode

Podés registrar un endpoint de webhooks con tu key sk_test_. Va a recibir eventos con livemode: false en el envelope. Para forzar el envío de un evento de prueba sin esperar tráfico:

curl
curl -s -X POST \
  "$ARGENTIVE_BASE/api/v1/webhook_endpoints/$WHE_ID/send_test" \
  -H "Authorization: Bearer $ARGENTIVE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "event_type": "transaction.cleared" }'

# { "delivered": true, "evt_id": "evt_test_01HW3..." }
Tip
Si estás desarrollando local, usá argentive listen --forward-to localhost:3000/webhook para hacer tunnel de webhooks de Argentive a tu máquina, similar a stripe listen.

Pasar a producción

  • Tu key sk_live_ se habilita una vez que firmás el agreement legal con Argentive y el card issuer asociado (KYB de tu empresa).
  • Los datos creados con sk_test_ NO migran a productivo. Tenés que re-onboardear a tus cardholders con la key live.
  • Los webhooks de productivo viajan a endpoints separados. Registrá los URLs de prod con sk_live_ antes del cutover.