Enlaces de pago

Qué incluye una factura#

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.

Nunca incluyas contraseñas, claves API, datos de tarjetas ni códigos bancarios en descripciones públicas. Usa un título de pedido y una referencia que el cliente reconozca.

• Nombre de la tienda, un título de pedido de hasta 120 caracteres y una descripción de hasta 500 caracteres.
• Monto base y una moneda explícita en USD, RUB o USDT.
• Métodos compatibles, comisión separada y proporciones de IVA, una referencia de pedido y caducidad del enlace.
• Las respuestas del propietario incluyen link.payment con el estado guardado de una operación existente; esto es independiente del estado de disponibilidad del enlace.

Cualquiera — el cliente elige#

Cualquiera selecciona todos los métodos compatibles con la moneda de la factura: tarjetas y Alipay para USD, SBP para RUB y cripto para USDT. La API usa una matriz de métodos concretos en lugar de la cadena cualquiera. Cada método tiene su propia cotización.

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.

Crear un enlace#

1. 1

   Abra los enlaces de pago en su cuenta.

2. 2

   Introduzca un título, monto, moneda y descripción. Establezca las participaciones de tarifa e IVA con los dos controles.

3. 3

   Mantenga Cualquiera para que el cliente elija, o seleccione métodos específicos. Establezca la expiración.

4. 4

   Compare el total de cada método y obtenga una vista previa del pago.

5. 5

   Reciba el enlace de pago listo inmediatamente después de la creación, luego cópielo para su cliente o widget.

Los términos permanecen con la factura#

Una factura guardada no cambia cuando cambian los ajustes de la tienda. Su precio, moneda, tarifa y participaciones de IVA, referencia de pedido y metadatos pertenecen a ese pedido. Esto mantiene el total consistente para un cliente que ya abrió el enlace.

Cree un nuevo enlace y pausa el anterior cuando cambien el precio, la descripción o la asignación de costos. Editar el monto de una URL no puede cambiar el cálculo del servidor.

Una página de pago dedicada#

Los enlaces del servidor se guardan en la base de datos y se abren en distintos dispositivos en /pay/… sin acceso a la cuenta del comerciante. Un cliente no necesita registrarse para ver una factura. Los saldos de la tienda, los ajustes y otros registros del cliente permanecen privados.

El ejemplo /pay/demo muestra la experiencia sin cobrar dinero. Los enlaces de demostración del navegador son datos de prueba y no deben presentarse como facturas reales.

Gestión de disponibilidad#

Pausar, cancelar o expirar un enlace bloquea una nueva operación. No oculta un pago ya enviado: el estado, la conciliación y un código bancario solicitado permanecen disponibles. La disponibilidad del enlace y el estado financiero se verifican por separado.

Reanudar levanta una pausa sin cambiar los términos. La cancelación es definitiva, y un enlace expirado no puede extenderse. Cree una nueva factura para un nuevo pedido o términos modificados, no para reintentar un cargo cuyo resultado es desconocido.

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.