Configuración de la tienda
Configuración: vincula el nombre de tu tienda, la regla de IVA y las notificaciones a tu cuenta verificada. Los cambios se guardan en el servidor para el usuario actual.
En esta página
Nombre de la tienda#
Elige un nombre corto y reconocible que tu cliente espere ver en el pedido. El nombre debe contener de 1 a 80 caracteres después de eliminar los espacios circundantes.
Un nombre para mostrar no reemplaza los datos legales ni tu acuerdo con el cliente. Mantén secretos, credenciales de pago e información personal de otras personas fuera de este campo.
Contribuyente de IVA#
El pagador predeterminado es el cliente. El IVA aplica solo a tarjetas y Alipay. Cambiar la configuración no modifica los totales de SBP ni de criptomonedas.
Las facturas existentes conservan sus términos guardados. Al crear una factura, el IVA del cliente y las participaciones de tarifas del 0 al 100% pueden anular los valores predeterminados. La preferencia de la tienda solo proporciona un valor predeterminado para facturas futuras.
Una preferencia guardada no amplía las capacidades de la pasarela. Los canales actuales de tarjeta en vivo y Alipay requieren 100% de IVA del cliente y 0% de tarifa de procesamiento del cliente; otras asignaciones guardadas permanecen como cálculos.
| Valor | Regla para una factura nueva |
|---|---|
| cliente | El IVA se añade al precio base del cliente |
| comerciante | El comerciante cubre el IVA desde el precio base |
Notificaciones de Telegram#
Selecciona las categorías de pagos, pagos, soporte y seguridad. Elegir una categoría controla las notificaciones; no activa un canal de pago ni genera eventos financieros.
Un mensaje de prueba verifica la entrega al chat privado vinculado. Su estado aparece en el centro de notificaciones y en GET /api/notifications. Un mensaje en cola aún no se ha entregado; también revisa Telegram.
Guardado y errores#
El formulario confirma un guardado completado. Si la red falla, tu entrada permanece disponible para reintentar; presionar Guardar solo no prueba que el cambio se haya almacenado.
Inicia sesión de nuevo cuando tu sesión expire. El servidor identifica la cuenta a partir de la sesión y no acepta otro ID de propietario de tienda desde el navegador.
Tema y datos de demostración#
El tema de visualización se guarda localmente en el dispositivo. El espacio de trabajo de demostración utiliza datos de navegador separados y no cambia la cuenta del servidor.
Restablecer la demostración elimina solo los registros de prueba en ese navegador. Una exportación de demostración no es un estado de cuenta bancario ni una prueba de pago.
Múltiples tiendas y un precio base en USD#
Elija Todas las tiendas para análisis y operaciones agregados, o seleccione una tienda para sus propios registros. Cada tienda tiene un storeId, nombre, IVA predeterminado, facturas, claves de API, endpoints de webhook, historial de eventos y aplicación web separados. Las notificaciones y tickets de soporte pertenecen a la cuenta. Una cuenta puede crear hasta 100 tiendas. Los registros existentes permanecen en su primera tienda.
Las facturas del nuevo espacio de trabajo usan pricingMode="universal" y un precio base en USD. Any incluye tarjeta, alipay, sbp y cripto; un comerciante puede seleccionar un subconjunto. Tarjetas y Alipay cobran en USD. SBP cobra en RUB usando el tipo de referencia USD/RUB del Banco de Rusia. Cripto cobra USDT bajo la regla explícita de factura 1 USD = 1 USDT. Esta es una regla de conversión de factura, no una cotización de mercado de USDT. La pasarela proporciona la tasa de la moneda seleccionada, el monto exacto de transferencia y las instrucciones antes de la transferencia.
El tipo de referencia y ambos montos se congelan al crear. Las facturas que implican conversión de RUB vencen dentro de 24 horas. Si no se puede obtener el tipo de referencia, la creación falla con FX_UNAVAILABLE; no se usa ningún tipo de respaldo inventado o desactualizado. El monto en minor del propietario y las cotizaciones usan la moneda contable USD. quotes[method].settlement contiene la cotización de cargo nativa. El checkout público expone la moneda de cargo seleccionada en currency, el precio original en baseAmountMinor/baseCurrency y el tipo de referencia en fx. Una vez que un pago ha sido despachado, su método no se puede cambiar; una factura tiene una operación de pasarela.
Cree una clave de API dentro de la tienda prevista y envíe Authorization: Bearer <key> desde su servidor. Su vinculación a tienda es inmutable; X-Kevmi-Store no puede otorgarle acceso a otra tienda. Las sesiones del navegador seleccionan X-Kevmi-Store: <storeId>; omitirlo selecciona la primera tienda. El valor all solo es aceptado por GET /api/account/dashboard y GET /api/payment-links. Las mutaciones requieren una tienda seleccionada, Origin y X-CSRF-Token. Los IDs de cuenta y los IDs de tienda son identificadores diferentes.
Por compatibilidad, las solicitudes de API sin pricingMode="universal" conservan el precio nativo y las restricciones de moneda originales. Las facturas existentes nunca se recalculan. Los recibos confirmados en análisis reflejan pagos verificados menos gastos de factura guardados; no son un saldo retirable. Las monedas de factura heredadas permanecen separadas y los pagos se gestionan con soporte. Cumpla un pedido solo después de verificar payment.fulfillmentReady=true y payment.status="succeeded" a través de la API del servidor, el historial de eventos o un webhook firmado.