Proveedores y routing

Cada comercio tiene uno o más proveedores habilitados, cada uno con su modo y su prioridad. Al pedir un checkout decides si usar un proveedor concreto o dejar que la API elija (auto).

Cómo se elige el proveedor

• El proveedor elegido aparece en la respuesta del checkout (provider) y en el intent.
• Disponible significa que el proveedor está respondiendo. Si uno falla repetidamente, se deja de usar por unos segundos y auto pasa al siguiente; un proveedor pedido explícitamente se usa igual mientras esté habilitado.
• Si el comprador ya interactuó con un checkout, no se cambia de proveedor por su cuenta: pide un checkout nuevo si quieres cambiarlo.

Modos

mode	Habla con	Uso
MOCK	el simulador	desarrollo y pruebas (solo aplicaciones sandbox)
SANDBOX	el ambiente de pruebas del proveedor	certificar tu integración
PRODUCTION	el proveedor real	cobros reales

Configurar los proveedores de un comercio

# listar
curl -s "$BASE/v1/admin/merchant-accounts/mrc_…/connectors" -H "Authorization: Bearer $KEY"

# agregar Webpay Plus con prioridad 10
curl -s -X POST "$BASE/v1/admin/merchant-accounts/mrc_…/connectors" \
  -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' \
  -d '{
    "provider": "transbank_webpay_plus",
    "mode": "SANDBOX",
    "enabled": true,
    "priority": 10,
    "credentials": { "commerce_code": "…", "api_key": "…" }
  }'

# bajarle la prioridad o deshabilitarlo
curl -s -X PATCH "$BASE/v1/admin/merchant-accounts/mrc_…/connectors/cfg_…" \
  -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' \
  -d '{ "priority": 30 }'

• priority: el número más bajo gana.
• credentials se escriben y nunca se devuelven: la respuesta solo indica has_credentials. Para Webpay Plus son commerce_code y api_key. Para Mercado Pago, coordina la habilitación con el equipo de la plataforma.
• Un comercio tiene como máximo un registro por proveedor: si ya existe, POST responde 409 CONNECTOR_CONFIG_ALREADY_EXISTS y se actualiza con PATCH.
• Cambiar el proveedor preferido de un comercio no requiere cambios en tu código si usas auto.