Onboarding de Cliente

Pasos para conectar un nuevo cliente al sistema.

Flujo completo

flowchart TD
    A["1️⃣ Admin crea API key"] --> B["2️⃣ Cliente hace OAuth"]
    B --> C["3️⃣ Crear sucursales + POS"]
    C --> D["4️⃣ Configurar terminales"]
    D --> E["5️⃣ Prueba de cobro"]
    E --> F["✅ Listo para producción"]

    style F fill:#00d4aa,color:#000

Paso 1: Crear API Key

El admin genera una API key para el nuevo cliente.

curl -X POST https://mercadopago.histrix.com.ar/api-keys \
  -H "Content-Type: application/json" \
  -H "x-api-token: ADMIN_TOKEN" \
  -d '{
    "client": "nuevo-cliente",
    "description": "Key para ERP producción"
  }'

Resultado: mk_a1b2c3d4... → guardar en el ERP del cliente.

Paso 2: Conectar cuenta de MercadoPago

El cliente (o el admin) abre en el navegador:

https://mercadopago.histrix.com.ar/oauth/login?client=nuevo-cliente

Esto redirige a MercadoPago donde el usuario autoriza la conexión. Al volver, el token OAuth queda guardado automáticamente.

Verificar:

curl https://mercadopago.histrix.com.ar/oauth/status \
  -H "x-api-token: mk_a1b2c3d4..."

Paso 3: Crear sucursales y POS

curl -X POST https://mercadopago.histrix.com.ar/stores \
  -H "Content-Type: application/json" \
  -H "x-api-token: mk_a1b2c3d4..." \
  -d '{
    "name": "Casa Central",
    "external_id": "SUC001",
    "location": {
      "street_name": "Av. Pellegrini",
      "street_number": "1234",
      "city_name": "Rosario",
      "state_name": "Santa Fe"
    },
    "pos": [
      { "name": "Caja 1", "external_id": "SUC001-POS001" },
      { "name": "Caja 2", "external_id": "SUC001-POS002" }
    ]
  }'

Paso 4: Verificar terminales

Después de que el cliente asigne las terminales físicas a los POS desde el panel de MercadoPago:

curl https://mercadopago.histrix.com.ar/terminals \
  -H "x-api-token: mk_a1b2c3d4..."

Cambiar a modo PDV si es necesario:

curl -X PATCH https://mercadopago.histrix.com.ar/terminals/operating-mode \
  -H "Content-Type: application/json" \
  -H "x-api-token: mk_a1b2c3d4..." \
  -d '{ "caja_id": "SUC001-POS001", "operating_mode": "PDV" }'

Paso 5: Prueba de cobro

# Crear orden
curl -X POST https://mercadopago.histrix.com.ar/orders \
  -H "Content-Type: application/json" \
  -H "x-api-token: mk_a1b2c3d4..." \
  -d '{
    "caja_id": "SUC001-POS001",
    "external_reference": "TEST-001",
    "amount": "10,00",
    "description": "Cobro de prueba"
  }'

# Simular pago (solo sandbox)
curl -X POST "https://mercadopago.histrix.com.ar/admin/orders/test-001/simulate?client=nuevo-cliente" \
  -H "Content-Type: application/json" \
  -H "x-api-token: ADMIN_TOKEN" \
  -d '{ "status": "processed", "status_detail": "accredited" }'

# Verificar estado
curl https://mercadopago.histrix.com.ar/orders/test-001 \
  -H "x-api-token: mk_a1b2c3d4..."