Conexión de YooKassa (Yandex Kassa)

Qué se necesita para la conexión

• Cuenta en YooKassa (yookassa.ru)
• Estatus de autónomo, sociedad limitada o trabajador por cuenta propia (para personas físicas sin estatus la aceptación de pagos no está disponible)
• Cuenta de liquidación vinculada a YooKassa

YooKassa está disponible en todos los planes de tikento, incluido Free.

Paso 1. Registro en YooKassa

Acceda a yookassa.ru y cree una cuenta. Para obtener acceso a pagos productivos necesitará pasar la verificación: cargar documentos (para autónomos — pasaporte y certificado, para sociedades limitadas — estatutos y orden de nombramiento).

El modo de prueba (pagos de prueba sin dinero real) está disponible inmediatamente después del registro sin verificación.

Paso 2. Creación de la tienda

En el panel de control de YooKassa:

1. Vaya a la sección Tiendas.
2. Haga clic en «Crear tienda».
3. Complete los datos: nombre, URL del sitio (indique app.tikento.com), descripción de la actividad.
4. En la sección «Método de conexión» seleccione Notificaciones HTTP (no widget).
5. Guarde la configuración.

Paso 3. Obtención de claves API

En la configuración de la tienda creada:

1. Abra la pestaña «Claves API».
2. Copie el shopId — identificador numérico de la tienda (por ejemplo, 123456).
3. Haga clic en «Crear clave secreta», introduzca la confirmación. Copie el secretKey con formato test_XXXX... (prueba) o live_XXXX... (productivo).

La clave secreta se muestra solo una vez. Si la pierde, cree una nueva; la anterior quedará invalidada.

Paso 4. Configuración en tikento

1. Abra la Configuración de su organización en tikento.
2. Vaya a la sección Pagos → YooKassa.
3. Introduzca el shopId y el secretKey.
4. Haga clic en «Verificar conexión» — tikento realizará una solicitud de prueba a la API de YooKassa.

Si la verificación es exitosa, aparecerá el estado verde «Conectado».

Paso 5. Configuración del webhook

Después de la verificación exitosa, tikento mostrará la URL del webhook para su tienda (con formato https://app.tikento.com/webhooks/yookassa/{shopId}).

En la configuración de la tienda de YooKassa:

1. Abra «Notificaciones HTTP».
2. Agregue la URL del webhook.
3. Seleccione los eventos a enviar:
   • payment.succeeded — pago completado exitosamente
   • payment.canceled — pago cancelado
   • refund.succeeded — reembolso completado

Paso 6. Pruebas

Para las pruebas, utilice la clave de prueba (que comienza con test_). Tarjetas de prueba de YooKassa:

Fecha de vencimiento — cualquier fecha futura, CVV — cualquier 3 dígitos.

Paso 7. Paso a modo productivo

Cuando las pruebas hayan sido exitosas:

1. En YooKassa envíe la solicitud para conectarse al modo productivo (botón en el panel de control de la tienda).
2. Cargue los documentos necesarios.
3. Después de la aprobación, YooKassa enviará una notificación.
4. Reemplace el secretKey de prueba por el productivo en la configuración de tikento.

La aprobación generalmente toma 1-3 días hábiles para autónomos y 3-5 días para sociedades limitadas.