Saltar al contenido
ESENIr al Portal

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.

ETAPA 1Creá una sedeen el PortalETAPA 2Asociá cada comercioPUT /my-integration/tenantETAPA 3Revisá a qué URL llega cada eventouna 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 del Portal aparece solo en integraciones con sedes habilitadas. Para habilitarlas, pedíselo a soporte.

  1. En el Portal, en 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:

    cURL
    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.

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.

Errores frecuentes

Ver los errores de sedes
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.
WebhooksFirma, reintentos y suscripción a eventos.ComisionesCobrar una comisión por cada pago.Conectar comerciosOAuth y tokens.Cómo funcionaUna integración y sus sedes.