> Chytapay es una plataforma de cobros por transferencia en Argentina. Esta página es parte de la doc de la Integration API: https://chytapay.com.ar/api/
> Conciliación recomendada: por CUIL. Ambientes: test (https://integration-api.test.chytapay.com.ar) y producción (https://integration-api.chytapay.com.ar).
> Página: "Sedes" (https://chytapay.com.ar/api/sedes/), actualizada el 2026-10-09.
> Índice completo para asistentes de IA: https://chytapay.com.ar/llms.txt

# Sedes

Cómo mandar los eventos de tus cuentas de comercio a la URL de cada sede, sin crear una integración por cliente.

Al terminar, cada cuenta de comercio va a mandar sus eventos a la URL de su sede. Necesitás una cuenta de comercio conectada: consultá [Conectar comercios](https://chytapay.com.ar/api/conectar-comercios/).

1. [Creá una sede](https://chytapay.com.ar/api/sedes/#como-se-arma): en el Portal
2. [Asociá cada comercio](https://chytapay.com.ar/api/sedes/#como-se-arma): PUT /my-integration/tenant
3. [Revisá a qué URL llega cada evento](https://chytapay.com.ar/api/sedes/#sede-vs-fanout): una sola por evento

## Qué es una sede




Una sede (**tenant** en la API y el Portal) manda los eventos de sus cuentas de comercio a una URL propia: una sucursal, una franquicia o cada cliente de tu SaaS. Con sedes tenés una sola integración, sin crear una por cliente.

### Cómo se relacionan

| Pieza              | Qué es                                                                                                                 |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------- |
| Integración        | Tu producto. Sus credenciales, suscripción a eventos y secreto de firma valen para todas las sedes.                    |
| Sede               | Una `key` que elegís vos, con su URL de webhook y un validation-token opcional. Solo cambia el destino de los eventos. |
| Cuenta de comercio | La que cobra. Está en una sola sede a la vez; una sede tiene muchas.                                                   |

## Creá una sede y asociá una cuenta de comercio

La sección [**Tenants**](https://chytapay.com.ar/portal/tenants) del Portal aparece solo en integraciones con sedes habilitadas. Para habilitarlas, pedíselo a soporte.

1. En el Portal, en [**Tenants**](https://chytapay.com.ar/portal/tenants), creá la sede con una `key` (única por integración), un nombre, la URL de webhook (HTTPS) y, si querés, un validation-token de 16 caracteres como mínimo. Desde ahí también la editás o la borrás: una sede con cuentas asociadas no se puede borrar.
2. Después de conectar el comercio por OAuth, asocialo a la sede con su `id_token`, en la Integration API:

   ```bash
   curl -X PUT https://integration-api.test.chytapay.com.ar/my-integration/tenant \
     -H "Authorization: Bearer $ID_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{ "tenantKey": "sucursal-centro" }'
   ```

   Desde ahí, los eventos de esa cuenta llegan a la URL de la sede. Podés probarlo con el [webhook de prueba](https://chytapay.com.ar/api/webhooks/#simular).

## A qué URL llega cada evento

Cada evento va a una sola URL. Gana la primera regla que se cumple:

| Situación                                     | A dónde va el evento                                                                                  |
| --------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| El cobro se creó con `webhookUrl`             | Solo a esa URL, sin `validation-token`. Solo para `payment_request.*`: `payment.unmatched` no la usa. |
| La cuenta de comercio está en una sede        | A la URL de la sede, con su `validation-token`                                                        |
| Sin sede, y la integración tiene una sola URL | A esa URL                                                                                             |
| Sin sede, y la integración no tiene URL       | A ninguna                                                                                             |

> **Atención:** Un evento sin destino no se envía ni se reintenta. Asociá cada cuenta de comercio a una sede antes de que cobre.

Todos se firman con el secreto de la integración: consultá [Webhooks](https://chytapay.com.ar/api/webhooks/).

## Errores frecuentes

| Error                                 | Cuándo                                                                                                                                            |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `409 TenantDuplicateKeyError`         | Ya tenés una sede activa con esa `key`: es única por integración.                                                                                 |
| `400 TenantWebhookUrlInvalidError`    | La URL apunta a una red privada o no se puede validar.                                                                                            |
| `409 TenantHasBoundUsersError`        | La sede que querés borrar todavía tiene cuentas de comercio.                                                                                      |
| `404` en `PUT /my-integration/tenant` | La `tenantKey` no existe, se borró o es de otra integración. Consultá [Operación y errores](https://chytapay.com.ar/api/operacion/#errores-sede). |

- [Webhooks](https://chytapay.com.ar/api/webhooks/): Firma, reintentos y suscripción a eventos.
- [Comisiones](https://chytapay.com.ar/api/cobrar-comision/): Cobrar una comisión por cada pago.
- [Conectar comercios](https://chytapay.com.ar/api/conectar-comercios/): OAuth y tokens.
- [Cómo funciona](https://chytapay.com.ar/api/concepts/): Una integración y sus sedes.