1. Card 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
        POST
      • Hacer un cargo o cargo diferido
        POST
      • Reembolsar una transacción
        DELETE
      • Anular una transacción
        DELETE
      • Solicitar opciones de diferido
        GET
      • Validar OTP
        POST
      • Información de BIN V2
        GET
      • Información de BIN
        GET
    • 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 🇨🇱
  1. Card Payments

Hacer un cargo o cargo diferido

https://api-uat.kushkipagos.com
https://api-uat.kushkipagos.com
POST
/card/v1/charges

Cargos diferidos en Ecuador 🇪🇨#

Si realizas un cargo diferido con credenciales de Ecuador, 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.

En la respuesta a 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.
  {
      name: "Diferido con intereses",
      type: "002",
      months: ["3", "6"],
      monthsOfGrace: ["1", "2", "3"]
    }
Algunos tipos de diferido que puede devolver 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.

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

Asegúrate de incluir el objeto threeDomainSecure en tu solicitud.
* Aplica en Ecuador 🇪🇨.
Tiempo de espera del endpoint: 29 s

Request

Header Params

Body Params application/json

Examples

Responses

🟢201Created
application/json
Created
Bodyapplication/json

🟠400Bad Request
🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location '/card/v1/charges' \
--header 'Private-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "token": "f5c64f7ac8ea42d5a58dcdc74de973dc",
    "amount": {
        "subtotalIva": 0,
        "subtotalIva0": 16.98,
        "ice": 0,
        "iva": 0,
        "currency": "USD"
    },
    "metadata": {
        "Referencia": "987654"
    },
    "contactDetails": {
        "documentType": "RUC",
        "documentNumber": "1234567890",
        "email": "user@example.com",
        "firstName": "John",
        "lastName": "Doe",
        "phoneNumber": "+593912345678"
    },
    "orderDetails": {
        "siteDomain": "example.com",
        "shippingDetails": {
            "name": "John Doe",
            "phone": "+593912345678",
            "address1": "Eloy Alfaro 139 y Catalina Aldaz",
            "address2": "centro 123",
            "city": "Quito",
            "region": "Pichincha",
            "country": "Ecuador"
        },
        "billingDetails": {
            "name": "John Doe",
            "phone": "+593912345678",
            "address1": "Eloy Alfaro 139 y Catalina Aldaz",
            "address2": "centro 123",
            "city": "Quito",
            "region": "Pichincha",
            "country": "Ecuador"
        }
    },
    "productDetails": {
        "product": [
            {
                "id": "198952AB",
                "title": "eBook Digital Services",
                "price": 10000,
                "sku": "10101042",
                "quantity": 1
            },
            {
                "id": "198953AB",
                "title": "eBook Virtual Selling",
                "price": 6980,
                "sku": "004834GQ",
                "quantity": 1
            }
        ]
    },
    "webhooks": [
        {
            "events": [
                "approvedTransaction",
                "declinedTransaction"
            ],
            "headers": [
                {
                    "label": "json",
                    "value": "12"
                }
            ],
            "urls": [
                "https://eof2hhkrta4ooo1.m.pipedream.net"
            ]
        }
    ],
    "webhooksChargeback": [
        {
            "events": [
                "initialized",
                "pending",
                "review",
                "approval",
                "declined",
                "failed",
                "expired"
            ],
            "headers": [
                {
                    "label": "json",
                    "value": "12"
                }
            ],
            "urls": [
                "https://eof2hhkrta4ooo1.m.pipedream.net"
            ]
        }
    ],
    "fullResponse": "v2"
}'
Response Response Example
201 - Without fullResponse
{
    "ticketNumber": "922513792073660814",
    "transactionReference": "6f16659e-b711-4995-a9ae-161aecbd6521"
}
Modified at 2026-09-11 15:01:43
Previous
Solicitar un token de tarjeta
Next
Reembolsar una transacción
Built with