1. One Click and Scheduled Payments
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
        POST
      • Crear un cargo recurrente
        POST
      • Actualizar los datos de la tarjeta del cargo recurrente
        PUT
      • Hacer un pago One-click
        POST
      • Cancelar un cargo recurrente
        DELETE
      • Actualizar un cargo recurrente
        PATCH
      • Agregar un cargo o descuento temporal
        PUT
      • Consultar información del cargo recurrente
        GET
    • 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 🇨🇱
  1. One Click and Scheduled Payments

Hacer un pago One-click

https://api-uat.kushkipagos.com
https://api-uat.kushkipagos.com
POST
/subscriptions/v1/card/{subscriptionId}
Realiza un One-click payment sobre un cargo recurrente existente, identificado por su subscriptionId, que fue creado en el endpoint Create a recurring charge.

¿Tienes tu propio motor de autenticación 3DS?*#

Producto en versión beta en Ecuador 🇪🇨 🔐👨‍💻#

Estamos trabajando en nuestra versión beta. ¡Mantente atento a su lanzamiento oficial! También puedes contactar a tu ejecutivo de cuenta para más información.
Asegúrate de incluir el objeto threeDomainSecure en tu solicitud.

Cargos diferidos en Ecuador 🇪🇨#

Si realizas un cargo diferido con credenciales de un comercio ecuatoriano, debes enviar el objeto deferred, que contiene creditType, graceMonths y months.

¿Cómo obtener las opciones de diferido disponibles?#

En cuanto se ingrese el número de tarjeta de tu cliente, debes usar el método Request deferred options para verificar si existen opciones de pago diferido para el BIN de la tarjeta ingresada por el usuario.

En la respuesta de esta llamada recibirás el nombre del diferido, el tipo (corresponde al creditType al ejecutar el cargo), los meses disponibles y los meses de gracia, como se muestra en el siguiente ejemplo de respuesta.
  {
      name: "Diferido con intereses",
      type: "002",
      months: ["3", "6"],
      monthsOfGrace: ["1", "2", "3"]
    }
Algunos tipos de diferido que pueden devolverse en la respuesta son:

Ecuador#

Diferido con meses de gracia sin intereses.
Diferido con meses de gracia con intereses.
Diferido cuota fija con intereses.
Diferido cuota fija sin intereses.
Diferido con intereses.
Diferido sin intereses.

Request

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢201Created
application/json
Bodyapplication/json

🟠400Bad Request
🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location '/subscriptions/v1/card/' \
--header 'Private-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "language": "es",
    "amount": {
        "subtotalIva": 0,
        "subtotalIva0": 5000,
        "ice": 0,
        "iva": 0,
        "currency": "USD"
    },
    "metadata": {
        "customerId": "123"
    },
    "contactDetails": {
        "documentType": "RUC",
        "documentNumber": "ABCD123456EF78",
        "email": "user@example.com",
        "firstName": "John",
        "lastName": "Doe",
        "phoneNumber": "+593912345678"
    },
    "orderDetails": {
        "siteDomain": "tuebook.com",
        "shippingDetails": {
            "name": "John Doe",
            "phone": "+593912345678",
            "address": "Centro 123",
            "city": "Quito",
            "region": "Pichincha",
            "country": "Ecuador",
            "zipCode": "64000"
        },
        "billingDetails": {
            "name": "John Doe",
            "phone": "+593912345678",
            "address": "Centro 123",
            "city": "Quito",
            "region": "Pichincha",
            "country": "Ecuador",
            "zipCode": "64000"
        }
    },
    "productDetails": {
        "product": [
            {
                "id": "198952AB",
                "title": "eBook Digital Services",
                "price": 6990000,
                "sku": "10101042",
                "quantity": 1
            },
            {
                "id": "198953AB",
                "title": "eBook Virtual Selling",
                "price": 9990000,
                "sku": "004834GQ",
                "quantity": 1
            }
        ]
    },
    "threeDomainSecure": {
        "collectionIndicator": "1",
        "directoryServerTransactionID": "f639774c-8e7c-4966-8eba-b8bae060a6ce",
        "eci": "01",
        "ucaf": "kEP6n7HiTM/4h4ZhSEFIOB6iQTpv",
        "specificationVersion": "2.2.0"
    },
    "fullResponse": "v2"
}'
Response Response Example
201 - One-click payment
{
    "ticketNumber": "124824724666494118",
    "transactionReference": "c897bafb-c78c-4cde-aa89-d44dd9b26ef7"
}
Modified at 2026-09-11 15:02:13
Previous
Actualizar los datos de la tarjeta del cargo recurrente
Next
Cancelar un cargo recurrente
Built with