1. Ecuador 🇪🇨
Español
  • English
  • Español
  • Docs para desarrolladores 🇪🇨
  • Online Payments
    • Notas de versión
    • Errores del API de Kushki
    • Card Payments
      • Solicitar un token de tarjeta
      • Hacer un cargo o cargo diferido
      • Reembolsar una transacción
      • Anular una transacción
      • Solicitar opciones de diferido
      • Validar OTP
      • Información de BIN V2
      • Información de BIN
    • One Click and Scheduled Payments
      • Solicitar un token de cargo recurrente
      • Crear un cargo recurrente
      • Actualizar los datos de la tarjeta del cargo recurrente
      • Hacer un pago One-click
      • Cancelar un cargo recurrente
      • Actualizar un cargo recurrente
      • Agregar un cargo o descuento temporal
      • Consultar información del cargo recurrente
    • Chargebacks
      • Consultar chargebacks
      • Solicitar exportación de chargebacks
    • Subscription Transactions
      • Consultar transacciones de suscripción
    • Cash in
      • Solicitar un token de Cash In
      • Iniciar transacción
      • Actualizar una transacción de Cash In
      • Estado de la transacción
      • Eliminar una transacción de Cash In
    • Transfer in
      • Solicitar un token de Transfer In
      • Iniciar transacción
      • Consultar estado
    • Analytics
      • Consultar listado de transacciones v2
    • Smartlinks
      • Crear un Smartlink
      • Actualizar un Smartlink
      • Consultar un Smartlink
      • Eliminar un Smartlink
    • Status
      • Consultar estado del gateway
      • Consultar estado de la plataforma
    • Commissions
      • Consultar configuración de comisiones
    • Payment Credentials
      • Crear una credencial
      • Buscar credenciales
      • Activar o desactivar
      • Eliminar credencial
      • Actualizar credencial
      • Regenerar una credencial
      • Búsqueda avanzada
    • Payment Button
      • Crear un Payment Button
    • Settlement
      • Consultar liquidación
  • Appian - Submerchant Register
    • Release Notes
    • Submerchant Validation in Batch
    • Query submerchant status by requestId/submerchantId
    • Get submerchantIds
    • Get credentials for submerchants
  • Schemas
    • threeDomainSecure
    • Card-old
    • Channel
    • SubscriptionTransactionsResponse
    • Card Present (CP)
    • Amount-cash-in
    • webhooks
    • ChargebackListResponse
    • StatusComponent
    • SettlementDateRangeRequest
    • Card
    • networkToken
    • ChargebackItem
    • SettlementRecord
    • Card Not Present (CNP)
    • currency
    • ErrorResponse
    • SubscriptionTransaction
    • Subscription
    • Amount
    • ErrorResponse400
    • SettlementResponse
    • Country
    • Deferred
    • extraTaxes
    • ErrorResponse401
    • Language
    • ErrorResponse403
    • Metadata
    • payment_method
    • ErrorResponse500
    • ContactDetails
    • orderDetails
    • Shipping Address
    • Billing-Address
    • payment_submethod
    • SubscriptionUpdate
    • documentType
    • SubscriptionAdjustmentRequest
    • threeDomainSecure
    • webhooks
    • headers
    • webhooksChargeback
    • citMit
    • network
    • binInfo
    • messageFields
    • UnexpectedErrorResponse
    • ExternalReferenceId
    • product
    • transactionType
    • SettlementTicketRequest
HomePerú 🇵🇪México 🇲🇽Ecuador 🇪🇨
Colombia 🇨🇴Chile 🇨🇱
HomePerú 🇵🇪México 🇲🇽Ecuador 🇪🇨
Colombia 🇨🇴Chile 🇨🇱
Status
Soporte / Support
Español
  • English
  • Español
  1. Ecuador 🇪🇨

Pagos en línea

El API de Online Payments de Kushki cubre todo el ciclo de vida del pago en Ecuador 🇪🇨: cobra a tus clientes con tarjeta o con métodos de pago locales, gestiona cargos recurrentes, crea páginas de pago alojadas y consulta el registro de transacciones para conciliación y reportería.

Moneda soportada#

MonedaCódigoNotas
Dólar estadounidenseUSDDos decimales — los montos usan centavos (p. ej., 10.00)

Tipos de documento#

ValorDescripción
CICédula de Identidad 🇪🇨
RUCRegistro Único de Contribuyentes 🇪🇨
PPPasaporte 🇪🇨

Cobrar pagos (Pay-in)#

Pagos con tarjeta
Acepta pagos con tarjeta de crédito y débito: cargos únicos, diferidos y autenticación 3DS.
Pagos One-Click y Programados
Guarda la tarjeta una sola vez y cóbrala on demand o de forma recurrente, sin volver a pedirle los datos al cliente.
Cash In
Acepta pagos en efectivo en redes de recaudación: genera una referencia de pago que el cliente paga en un punto de venta físico.
Transfer In
Acepta transferencias bancarias: genera una referencia de transferencia y recibe los fondos cuando el cliente completa la transferencia.

Herramientas de pago#

Smartlinks V2
Crea páginas de pago alojadas y comparte un enlace con tus clientes, sin necesidad de integración en el frontend.
Payment Button
Integra un botón de pago alojado por Kushki directamente en tu sitio web o plataforma de e-commerce.

Gestión del comercio#

Payment Credentials
Crea, rota, activa y elimina pares de llaves de API de tu cuenta de comercio de forma programática.
Comisiones
Consulta las tarifas de comisión y las estructuras de costos aplicables a tu cuenta de comercio.

Reportería y conciliación#

Analytics
Consulta todo tu historial de transacciones, paginado y con filtros flexibles para conciliación y monitoreo.
Liquidación
Obtén los registros de liquidación por rango de fechas o por número de ticket, incluidos montos, comisiones y pagos netos.
Chargebacks
Busca y exporta registros de chargebacks: filtra por estado, fecha y tipo.
Transacciones de suscripción
Consulta el historial de transacciones de una suscripción específica.

Estado y monitoreo#

Estado del gateway y de la plataforma
Revisa en tiempo real el estado operativo del gateway de pagos de Kushki.
Estado de la plataforma
Monitorea la disponibilidad de los servicios centrales de la plataforma de Kushki.

Patrón común de solicitud#

La mayoría de las operaciones de pay-in con tarjeta siguen un flujo token → cargo:
1. POST /card/v1/tokens          → one-time token (use immediately)
2. POST /card/v1/charges         → charge using the token
Tu servidor nunca almacena los datos de la tarjeta en crudo: Kushki maneja toda la información sensible a través del token.

Pagos diferidos (Diferido)#

Ecuador admite varios tipos de pago diferido. Llama siempre primero a Request Deferred Options para confirmar qué valores de creditType y months son válidos para el BIN de la tarjeta del cliente.
creditTypeDescripción
002Diferido con intereses
003Diferido sin intereses
004Diferido con meses de gracia sin intereses
005Diferido con meses de gracia con intereses
007Diferido cuota fija sin intereses
008Diferido cuota fija con intereses
WARNING
Los valores válidos de creditType y months dependen del BIN de la tarjeta. Llama siempre a Request Deferred Options antes de iniciar un cargo diferido.

Autenticación#

Todos los endpoints usan las llaves de tu comercio en las cabeceras de la solicitud. Usa la Private Key para todas las llamadas servidor a servidor; nunca la expongas en código del frontend.
Algunas operaciones (por ejemplo, las consultas de BIN iniciadas desde el navegador) aceptan la Public Key:

Usar el API#

🟢 Producción
🧪 Sandbox (UAT)
https://api.kushkipagos.com/
¿Tienes alguna sugerencia sobre esta documentación? Escríbenos.
Modified at 2026-09-11 14:47:04
Previous
Docs para desarrolladores 🇪🇨
Next
Notas de versión
Built with