transferfix.
Empezá gratis

Usabilidad de alias · Sandbox → Prod

Integrá la API de alias

Pegá un solo prompt en tu asistente de IA y construye toda la integración —sandbox y producción— en una pasada. Abajo tenés los conceptos y, detrás de cada toggle, el comando para copiar.

Sin registroUn solo promptSandbox y prod

Integrá con tu agente

Un único prompt con todo lo técnico que TransferFix necesita para funcionar —auth, entornos sandbox y prod, los endpoints, el webhook firmado y cómo probarlo— listo para pegar en Claude Code, Cursor o el asistente que uses.

Un prompt. Toda la integración.

Pegalo en tu asistente dentro del repo de tu app. Construye el alta por orden con idempotencia, el receptor de webhook con verificación de firma, los lookups de alias y el fallback por polling — probado primero en el sandbox, sin tocar producción.

Probá el sandbox (sin registro)

Entorno simulado y aislado: no mueve plata real. Pegá el comando y recibís un alias real de vuelta. Para llevarlo a PAID, simulá una transferencia.

EntornoBase URLKeyBanco
Sandboxhttps://www.transferfix.com.ar/sandboxck_test_edef5599-f8ad-4c68-bd02-6af545ee2364_1781932801007 (pública)Simulado — seguro a fondo
Producciónhttps://www.transferfix.com.arck_live_… (tu key)Real (vía relay)
Smoke test — creá un alias ahora
pegá y ejecutá
# Creá una cuenta en el sandbox — sin registro, key de test compartida, entorno simulado.
curl -X POST "https://www.transferfix.com.ar/sandbox/api/v2/accounts" \
  -H "X-API-Key: ck_test_edef5599-f8ad-4c68-bd02-6af545ee2364_1781932801007" \
  -H "Idempotency-Key: smoke-test-1" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_email": "comprador@ejemplo.com",
    "total_amount": 12500,
    "currency": "ARS",
    "alias_strategy": "sequence",
    "series": "demo"
  }'
# → { "success": true, "data": { "account_id": …, "cucuru_alias": "…demo.0001", … } }

Esta key es pública a propósito

ck_test_edef5599-f8ad-4c68-bd02-6af545ee2364_1781932801007 es una key compartida solo de sandbox. Va contra un entorno simulado aislado — no puede tocar producción ni mover plata real. Solo necesitás tu propia key ck_live_ para producción.

Casos de uso

Los cinco casos, en una línea cada uno. El prompt de arriba ya los implementa todos — acá tenés el comando suelto para probar a mano. Apuntan al sandbox; para prod, cambiá base + key.

Aliases secuenciales

TransferFix es dueño del contador: mirá el próximo número sin consumirlo y creá con alias_strategy:sequence. Dos callers nunca colisionan.

GET/aliases/nextPOST/accounts

Alias explícito + idempotente

Mandá un alias exacto + un Idempotency-Key. Un repetido es un replay; un alias tomado devuelve un 409 estructurado con la cuenta canónica.

POST/accounts

¿Este alias está usado?

Consultá un alias por in_use + status, o escaneá toda la lista con campos de uso en cada fila. Sin mantener un espejo local.

GET/accounts/aliases/{alias}GET/accounts/aliases

Previsualizar (canonicalize)

Resolvé un order_reference al alias que derivaría, o validá un alias explícito y chequeá in_use, antes de crear.

GET/aliases/canonicalize

Reuso de alias

Liberá un alias pagado a CREATED y reasigná la próxima orden sobre la misma cuenta, sin crear una nueva.

POST/accounts/{n}/resetPATCH/accounts/{n}

Pasá a producción

Cuando el flujo del sandbox pasa, ir a producción es cambiar dos valores — las formas de los requests y tu código quedan idénticos.

Cambiá dos valores para ir a producción
base + key
# Ir a producción = cambiar dos valores. Todo lo demás es idéntico.
# Sandbox:
BASE="https://www.transferfix.com.ar/sandbox";  KEY="ck_test_edef5599-f8ad-4c68-bd02-6af545ee2364_1781932801007"
# Producción:
BASE="https://www.transferfix.com.ar";  KEY="ck_live_<tu-key>"

# después:  curl -H "X-API-Key: $KEY" "$BASE/api/v2/..."

Antes de pasar a prod

Conseguí tu key ck_live_, mantené todas las llamadas del lado del servidor, registrá un webhook_secret (≥32 chars) en el primer create y reusalo, y verificá el HMAC X-Transferfix-Signature en cada webhook entrante. Nunca confíes en montos que mande el cliente.
Transferfix API Docs