Inicio rápido

1. Explora el producto#

Abre el espacio de trabajo de demostración para crear un pedido de prueba, explora los enlaces de pago y revisa un cálculo de comisiones. La demostración utiliza datos de prueba separados. No crea un pago bancario ni transfiere fondos a una billetera.

2. Crea una cuenta con Telegram#

Después de iniciar sesión con Telegram, se abre la cuenta del comerciante. La incorporación web está en /account#applications; tanto el formulario como el seguimiento individual en /account#applications/{id} permanecen dentro de la aplicación.

Un nuevo pago e intento de tarjeta requieren que la última solicitud de revisión web del comerciante esté aprobada. La aprobación por sí sola no conecta la pasarela de pago. Si la revisión cambia después del envío, la operación existente permanece disponible para lecturas de estado, conciliación y un código bancario solicitado.

3. Configura tu tienda#

1. 1

   Elige un nombre de tienda que tu cliente reconozca.

2. 2

   Elige una regla de IVA predeterminada. Cada factura nueva acepta por separado participaciones de comisión del cliente e IVA del 0 al 100%.

3. 3

   Selecciona las notificaciones que deseas recibir en Telegram.

4. 4

   Usa la calculadora para verificar el monto típico de un pedido.

4. Prepara un enlace de pago#

Ingresa un título de pedido claro, un monto y una moneda. El cliente obtiene una página dedicada con los detalles de la compra y el total a pagar. Una factura existente conserva sus términos originales cuando cambian los ajustes de tu tienda.

5. Verifica la disponibilidad del pago#

Administra facturas, claves de API, widgets y webhooks desde tu cuenta. Antes del pago, Kevmi verifica la configuración de la pasarela, la aprobación del comerciante, el monto y los términos de la factura. Si el método seleccionado no está disponible, el pago explica el motivo.

Las facturas del nuevo espacio de trabajo usan un precio base en USD y Any ofrece los cuatro métodos. SBP convierte a RUB al tipo de referencia congelado del Banco de Rusia; cripto usa la regla explícita de factura 1:1 USD/USDT. El precio nativo heredado sigue disponible para facturas antiguas y solicitudes de API sin pricingMode=universal. Consulte la sección de múltiples tiendas y precios en USD a continuación.

Para un pago nuevo en vivo con tarjeta o Alipay, la pasarela actual solo admite feeCustomerPercent=0 y vatCustomerPercent=100: el comerciante cubre toda la comisión de procesamiento y el IVA se añade completo para el cliente. Otras participaciones se pueden guardar y calcular en una factura, pero la ejecución está bloqueada con unsupported_allocation. El servidor nunca cambia silenciosamente los términos guardados. Los pagos cripto SBP y USDT admiten todas las participaciones de comisión de procesamiento y no tienen IVA.

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.