1. Web
Español
  • English
  • Español
  • Inicio
  • Integración con MCP
  • Cómo usar API Docs
  • Libraries & SDKs (Online Payments)
    • Notas de versión
    • Mobile
      • Kushki Android
      • Kushki iOS 
      • Configuración ARM de Kushki iOS
    • Web
      • Kushki.js 🌐
      • kushki.js-hosted-fields
        • kushki.js Hosted Fields
        • Migrar a Kushki.js 2.0
        • Antifraud
          • Interfaces
            • SiftScienceObject
            • SecureInitRequest
            • SecureInitResponse
          • Methods
            • requestInitAntiFraud
            • requestSecureInit
            • requestValidate3DS
        • Card
          • CarApplePay interface
            • Interfaz ICardApplePay
          • Card-Interface
            • Interfaz ICard
            • Interfaz ICardSubscriptions
          • Errors
            • Lista de errores
          • Interfaces
            • MasterCardBrandingRequest
            • Interfaz ApplePayGetTokenOptions
            • Interfaz ApplePayOptions
            • ApplePayPaymentContact
            • AppleTokenResponse
            • CardFieldValues
            • CardOptions
            • DeviceTokenRequest
            • Fields
            • FormValidity
            • SecureDeviceTokenOptions
            • Styles
            • TokenResponse
            • Amount
            • Interfaz BrandByMerchantResponse
            • CardInfo
            • CardTokenResponse
            • DeferredByBinOptionsResponse
            • DeferredInputValues
            • DeferredValuesResponse
            • Field
            • FieldInstance
            • FieldValidity
            • VisaBrandingRequest
          • Methods
            • initApplePayButton
            • initCardToken
            • initSecureDeviceToken
            • Método requestBrandsByMerchant
            • Método requestDeviceToken
            • requestInitCardBrandingAnimation
          • Types
            • CssProperties
            • Moneda
            • FieldTypeEnum
        • Card Payouts
          • Card Payouts Interface
            • ICardPayouts
          • Enumerations
            • Enumeración `InputModelEnum`
          • Errors
            • Errores
          • Interfaces
            • CardPayoutOptions
            • CardPayoutSubscriptionTokenResponse
            • CardPayoutUniqueTokenResponse
            • Field
            • Fields
            • FieldValidity
            • Interfaz FormValidity
            • Interfaz `Styles`
          • Methods
            • initCardPayoutToken
          • Type Aliases
            • CardPayoutTokenResponse
            • InputTypeEnum
          • Types
            • CssProperties
        • Kushki
          • Methods
            • Función init
            • Función requestBankList
            • Función requestCommissionConfiguration
          • Classes
            • KushkiError
          • Interfaces
            • IKushki
            • KushkiOptions
            • CommissionConfigurationRequest
Home
Perú 🇵🇪México 🇲🇽Ecuador 🇪🇨Colombia 🇨🇴Chile 🇨🇱
Home
Perú 🇵🇪México 🇲🇽Ecuador 🇪🇨Colombia 🇨🇴Chile 🇨🇱
Status
Soporte / Support
Español
  • English
  • Español
  1. Web

Kushki.js 🌐

Kushki.js es nuestra librería de JavaScript para construir flujos de pago con tu propio estilo. Puedes recolectar toda la información de la tarjeta de tu cliente y generar un token que guardará y enviará esos datos de forma segura a tus servidores.
We make it easier!
Importar Kushki.js
Uso
Ejemplos
One-time Payment
Recurring Charges
Payouts
Others
Referencia
One-time Payment
Cargos recurrentes
Dispersiones
Otros

Importar Kushki.js#

Option 1 - CDN
Usa una etiqueta script dentro de tu página para agregar las funcionalidades. Al agregar el siguiente código a tu página, se importará.


Option 2 - NPM
Instala el npm con el siguiente código:


Luego, impórtalo a tu espacio de trabajo de desarrollo con el siguiente código:


Importante
Agrega las siguientes líneas a tu código solo si usas Angular 6 o una versión superior junto con el paquete npm de Kushki. Esto ayuda con el problema que aparece cuando no es posible resolver 'net'/'global' u otros globales de node. Encuentra más información en el repositorio de Angular en GitHub.
Agrega el siguiente código en tu proyecto:


Cada vez que ejecutes npm install, incluye el siguiente código en tu package.json como parte de los scripts de postinstall:


Uso#

Empieza creando tu Kushki: te permitirá ejecutar todas las funciones disponibles en Kushki.js.


Requerido

PropiedadTipoDescripciónPredeterminadoValores posibles
merchantIdStringID de Kushki creado para tu comercio
inTestEnvironmentbooleanValor para definir si estás en ambiente de producción o de pruebasfalsetrue , false

Opcional

PropiedadTipoDescripciónPredeterminadoValores posibles
regionalBooleanDefine si se usa una IP estática para acceder a Kushkifalsetrue,false

Ejemplos#

Encuentra los métodos disponibles en nuestra librería Kushki.js junto con ejemplos.

Ejemplos de pago único#

Nota: El token que entrega Kushki solo cifra y envía información. Si quieres guardar la información de la tarjeta para compras futuras, ve a la sección Ejemplos de cargos recurrentes.
Card
Card Async
Apple Pay
Transfer In
Transfer In (México)
Cash In

requestToken()#

Para crear un token de tarjeta, puedes usar esta función:

Solicitud#



Requerido

PropiedadTipoDescripciónPredeterminadoValores posibles
amountStringEl monto que vas a cobrar, como string
currencyStringCódigo de la moneda usadaUSDUSD, COP, CLP, UF, PEN, MXN
cardObjectLos datos de la tarjeta recolectados en un objeto card
callbackFunction(response)La función callback creada* Éxito : { token: "90a9f2d93ba508c38971890454897fd4"} * Con la validación OTP activada : { token: "90a9f2d93ba508c38971890454897fd4", secureId: "5e44449e-869b-4fed-bbca-e1bfa5af53c3", secureService: "KushkiOTP"} * Error: { message:"error-message", code:"error-code", error: "error-message"}

Opcional

PropiedadTipoDescripciónValores posibles
monthsIntegerNúmero de cuotas. Requerido solo para transacciones diferidas en ChileMínimo: 2, máximo: 48

Respuesta#

La respuesta exitosa llegará en la función (callback):

{ 
    "token": "90a9f2d93ba508c38971890454897fd4"
}

Esta es la respuesta cuando el comercio tiene activada la validación OTP:

{ 
    "token": "90a9f2d93ba508c38971890454897fd4",
    "secureId": "5e44449e-869b-4fed-bbca-e1bfa5af53c3",
    "secureService": "KushkiOTP"
}

Esta es la respuesta cuando el comercio tiene activada la validación 3DS:

{ 
    "token": "90a9f2d93ba508c38971890454897fd4",
    "secureId": "1c3a9ada-1287-4f8b-b1a9-dadf44a39dd3",
    "secureService": "3dsecure",
    "security": {
        "acsURL": "",
        "authenticationTransactionId": "OWgXwASsYPW4hr1ATcf0",
        "authRequired": true,
        "paReq": "sandbox",
        "specificationVersion": "1.0.2"
    }
}

La respuesta de error llegará en la función (callback):#

{ 
  "message":"error-message", 
  "code":"error-code",
  "error": "error-message"
}

requestSecureServiceValidation() para OTP#

Para validar el OTP que ingresó el cliente:

Solicitud#



Requerido

PropiedadTipoDescripciónValores posibles
secureServiceIdStringEl secureId que obtienes de la solicitud del token
otpValueStringNúmero de tres dígitos que corresponde al OTPEn el sandbox del OTP, el valor cambia según la moneda de la tarjeta de crédito: 155 para USD y PEN, 555 para COP y MXN, 150 para CLP
callbackFunction(response)La función callback creada* Éxito : { isValid: true} * Error: { message:"error-message", code:"error-code", error: "error-message"}

Respuesta#

La siguiente respuesta llegará en la función (callback):

{
  "code": "OTP000", 
  "message": "ok"
}

Si la transacción se declina por la autenticación, su resultado se incluye como parte de la respuesta del cargo con 322 y cualquiera de los subcódigos especificados en la lista de códigos de error.

requestSecureInit()#

OPCIONAL. Este método te permite obtener el Json Web token (JWT) para integraciones 100% API con 3DS.

Solicitud#



Requerido

PROPIEDADTIPODESCRIPCIÓNVALORES POSIBLES
cardObjectNúmero de bin (8 dígitos) recolectado en un objeto

Respuesta#

La respuesta exitosa llegará en la función (callback):

{
  "jwt": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2NTQ2NTY4ODYsImlhdCI6MTY1NDY0OTY4NiwiaXNzIjoiNWVhMzJmZDJmZjQ2NDU2OTY3YjUyNDliIiwianRpIjoiMDFhZTQyYWUtYzMyZS00YWRjLWFmOWQtZWVhMmFlNjRkMDkxIiwiT3JnVW5pdElkIjoiNWVhMzJmZDJhZDA3ZDIxYTM2OTc4OGFlIiwiUmVmZXJlbmNlSWQiOiI3ZjY1NzM5NS0yMDIwLTQ1ZjEtOTY4Mi05MzJiNTU5YWYzMWIifQ.JUkk70Kg4KlUYW7eIvsW8LoDhxJeG8P00VrJH9oQipc"
}

La respuesta de error llegará en la función (callback):#

{ 
  "message":"error-message", 
  "code":"error-code",
  "error": "error-message"
}

requestValidate3DS()#

OPCIONAL. Este método permite realizar la autenticación 3DS por parte del tarjetahabiente en caso de que sea requerida.
¡Ten en cuenta!
La autenticación 3DS con kushki.js solo funciona en una aplicación web. Si el usuario intenta pagar desde un dispositivo móvil, la autenticación 3DS no se realiza.

Solicitud#



Usa las siguientes tarjetas en modo de pruebas para asegurarte de que tu integración está lista. Úsalas con cualquier CVV, 1234 como código OTP y fecha de expiración futura.
Transaction approved with 3DS authentication required:
4456528080389860
4456529267234200
4456529165328302
4456524869770255
4456523340069956
Transaction approved without 3DS validation:
4456540000000063
4456543371713314
4456541982068615
4456541249811088

Parámetros#


PROPIEDADTIPODESCRIPCIÓNVALORES POSIBLES
secureIdStringEl secureId que obtienes de la respuesta del token o del token de cargo recurrente
securityObjectEl objeto security que recibes en la respuesta del token
acsURLStringURL de la página de challenge del emisor
authenticationTransactionIdStringID de la transacción verificada por las marcas.
specificationVersionStringVersión de 3D Secure
paReqStringEste parámetro contiene los datos de la transacción comprimidos y codificados en Base64. Lo recibes de las marcas.
authRequiredBooleanIdentifica si el challenge 3DS es requerido o no.
callbackFunction(response)La función callback creada

Respuesta#

La siguiente respuesta llegará en la función (callback):

{isValid: true}

La respuesta de error llegará en la función (callback):#

{ 
  "message":"error-message", 
  "code":"error-code"
}

Si la transacción se declina por la autenticación, su resultado se incluye como parte de la respuesta del cargo con 322 y cualquiera de los subcódigos especificados en la lista de códigos de error.

requestDeferred()#

Para obtener las opciones de diferido según las configuraciones de diferido del comercio definidas en el Backoffice:

Solicitud#



Requerido

PropiedadTipoDescripción
binStringEl bin que se va a validar para las opciones de diferido
callbackFunction(response)La función callback creada

Respuesta#

La respuesta exitosa llegará en la función (callback):

Ecuador#

[
  {
    "name": "Diferido Cuota Fija sin intereses",
    "type": "04",
    "months": ["3", "6", "12"],
    "monthsOfGrace": ["1", "2"]
  },
  {
    "name": "Diferido Cuota Fija con intereses",
    "type": "01",
    "months": ["3", "6", "9"],
    "monthsOfGrace": []
  }
]

Chile: Cuotas Emisor y Cuotas Comercio disponibles#

[
  {
    "type": "ALL",
    "months": ["2", "3", "4", "...", "48"],
    "monthsOfGrace": []
  },
  {
    "type": "03",
    "months": ["2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12"],
    "monthsOfGrace": []
  }
]
La funcionalidad de Cuotas Comercio (Merchant Installments) —identificada con el type específico "03"— está actualmente en Beta.
ParámetroTipoDescripciónPaíses/Notas
namestringEl nombre de la opción de pago diferido (p. ej., "Diferido con intereses," "Meses sin intereses," "Regular").Nota: Este campo no siempre viene en la respuesta.
typestringUn código que identifica el tipo de opción de diferido.El valor puede ser un código específico (p. ej., "001", "002") o la palabra clave "ALL" para países como Perú o Colombia, donde aplica a todas las opciones de diferido.
monthsstring[]Un array de los plazos de pago disponibles (número de meses).Requerido para pagos diferidos.
monthsOfGracestring[]Un array de los periodos de gracia disponibles en meses.Este campo es opcional y solo está presente si el banco o la tarjeta permite un periodo de gracia para ese tipo de diferido.
La respuesta de error llegará en la función (callback):#

{ 
  "code":"error-code",
  "message":"error-message",
}

requestBinInfo()#

Devuelve un objeto con la información relacionada al bin de la tarjeta de crédito (los primeros ocho dígitos). Para los comercios chilenos, la respuesta ayuda a decidir si continuar con la solicitud de un token de tarjeta (cuando cardType es CREDIT) o con la solicitud de un token de card async (cuando cardType es DEBIT):

Solicitud#



Requerido

PropiedadTipoDescripción
binStringLos primeros ocho dígitos de la tarjeta de crédito
callbackFunction(response)La función callback creada

Respuesta#

La respuesta exitosa llegará en la función (callback):

{
    "bank": "BANCO DE LA PRODUCCION S.A. (PRODUBANCO)",
    "brand": "visa",
    "cardType": "debit",
    "country": "Ecuador"
}

La respuesta de error llegará en la función (callback):

{ 
  "code":"error-code",
  "message":"error-message",
}

Ejemplos de cargos recurrentes#

Card
Card Async
Apple Pay

requestSubscriptionToken()#

Para crear un token de cargo recurrente, puedes usar esta función:

Solicitud#



Requerido

PropiedadTipoDescripciónPredeterminadoValores posibles
cardObjectLos datos de la tarjeta recolectados en un objeto card
currencyStringCódigo de la moneda usadaUSDUSD, COP, CLP, UF, PEN, MXN
callbackFunction(response)La función callback creada* Éxito : { token: "90a9f2d93ba508c38971890454897fd4"} * Error: { message:"error-message", code:"error-code", error: "error-message"}

Respuesta#

La respuesta exitosa llegará en la función (callback):

{ 
  "token": "90a9f2d93ba508c38971890454897fd4"
}

La respuesta de error llegará en la función (callback):#

{ 
  "message":"error-message", 
  "code":"error-code",
  "error": "error-message" 
}

Esta es la respuesta cuando el comercio tiene activada la validación 3DS:

{
    "token": "oaACBE1012310zYTjE239227yqFRA8r7",
    "secureService": "3dsecure",
    "secureId": "e356d68d-3f31-4134-a9a7-8cba46b3cdac",
    "security": {
        "acsURL": "https://authentication.cardinalcommerce.com/ThreeDSecure/V1_0_2/PayerAuthentication?issuerIdÒaa20412b0063aca652facd9g4transactionId=Qhcf3XOjdZmjve336Vee2gb5rof1",
        "authenticationTransactionId": "1d8cf7jg5Bfn8Nj73mn7",
        "paReq": "eNpVUtluwjAQfPdXoH5A7DghtGixxFUViRt6iDfXGGJCDpykQL++doDSvu3sjtYzs4ZlqKXsLaQotWQwknnOt7Km1q2HyeIx6EW7w2dn09NjFXnxxn1gMG3P5YHBl9S5ShPmOsShgG8QmRVahDwpGHBx6AzGzKdXoH5A7DghtGixxpVUtluwjAQfPdXoH5A7DghtGixs4ZlqKXsLaQot0u4KqLQKRlUugzC4gP+AYQlHrPwqLImhgfj0cnKvMwUhnfprkj0hiwnSPAxn1gMG3P5YHBl9S5ShPmOsShOqLqJ7x73Gx2vVbgC0DwZoXklFCKXFpo0bcpu83qWht0u4KqLQKRlUugzC4gP+AYQlHrpfUGenfxtGEOl1jIRN0c3hECesjSRhmNC+62Nh7vy7otNVxQmtdkm3Ew/Jrv1Kp0X4elF8Pb6p/n2KH/k0skaqcyeVHfdaulqgoP20X4elF8Pb6p/n2KH/k0sv8=",
        "specificationVersion": "1.0.2",
        "authRequired": true
    }
}

Esta es la descripción de esas variables:

ParámetroTipoDescripción
authRequiredBooleanEste campo indica si se requiere un challenge 3DS o no.
acsURLStringSe refiere a la URL de la página de challenge que el usuario debe superar (Access Control System)
specificationVersionStringSe refiere a la versión de 3DS
authenticationTransactionIdStringID de la transacción verificada por Visa y Mastercard
paReqStringPayer Authentication Request. Es un campo codificado en base64 que contiene información de tu comercio y del tarjetahabiente, y que se envía al emisor para la autenticación.

Nota: si estás probando en un ambiente UAT, debes enviar sandbox.

Una vez que recibas la respuesta del Token con la estructura anterior, debes enviar el objeto security a Kushki consumiendo el método requestValidate3DS:

requestSecureInit()#

OPCIONAL. Este método te permite obtener el Json Web token (JWT) para integraciones 100% API con 3DS.

Solicitud#



Requerido

PROPIEDADTIPODESCRIPCIÓNVALORES POSIBLES
cardObjectNúmero de bin (8 dígitos) recolectado en un objeto

Respuesta#

La respuesta exitosa llegará en la función (callback):

{
  "jwt": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2NTQ2NTY4ODYsImlhdCI6MTY1NDY0OTY4NiwiaXNzIjoiNWVhMzJmZDJmZjQ2NDU2OTY3YjUyNDliIiwianRpIjoiMDFhZTQyYWUtYzMyZS00YWRjLWFmOWQtZWVhMmFlNjRkMDkxIiwiT3JnVW5pdElkIjoiNWVhMzJmZDJhZDA3ZDIxYTM2OTc4OGFlIiwiUmVmZXJlbmNlSWQiOiI3ZjY1NzM5NS0yMDIwLTQ1ZjEtOTY4Mi05MzJiNTU5YWYzMWIifQ.JUkk70Kg4KlUYW7eIvsW8LoDhxJeG8P00VrJH9oQipc"
}

La respuesta de error llegará en la función (callback):#

{ 
  "message":"error-message", 
  "code":"error-code",
  "error": "error-message"
}

requestValidate3DS()#

OPCIONAL. Este método permite realizar la autenticación 3DS por parte del tarjetahabiente en caso de que sea requerida.

Solicitud#



Usa las siguientes tarjetas en modo de pruebas para asegurarte de que tu integración está lista. Úsalas con cualquier CVV, 1234 como código OTP y fecha de expiración futura.
Transaction approved with 3DS authentication required:
4456528080389860
4456529267234200
4456529165328302
4456524869770255
4456523340069956
Transaction approved without 3DS validation:
4456540000000063
4456543371713314
4456541982068615
4456541249811088
Parámetros

PROPIEDADTIPODESCRIPCIÓNVALORES POSIBLES
secureIdStringEl secureId que obtienes de la respuesta del token o del token de cargo recurrente
securityObjectEl objeto security que recibes en la respuesta del token
acsURLStringURL de la página de challenge del emisor
authenticationTransactionIdStringID de la transacción verificada por las marcas.
specificationVersionStringVersión de 3D Secure
paReqStringEste parámetro contiene los datos de la transacción comprimidos y codificados en Base64. Lo recibes de las marcas.
authRequiredBooleanIdentifica si el challenge 3DS es requerido o no.
callbackFunction(response)La función callback creada

Respuesta#

La siguiente respuesta llegará en la función (callback):

{isValid:true}

La respuesta de error llegará en la función (callback):#

{ 
  "message":"error-message", 
  "code":"error-code"
}

Si la transacción se declina por la autenticación, su resultado se incluye como parte de la respuesta del cargo con 322 y cualquiera de los subcódigos especificados en la lista de códigos de error.
Si el valor de la variable authRequired es igual a true, se muestra el modal de validación OTP y tu cliente recibe por correo electrónico o mensaje de texto el valor que debe ingresar.
Si el valor de la variable authRequired es igual a false, el modal de validación OTP no se muestra.
La respuesta de esta llamada llega en la función callback. Si es positiva, envía el token al back-end para continuar con la transacción.

requestDeviceToken()#


Este método es requerido para ejecutar pagos one-click. Encuentra más información en nuestra guía para generar pagos One-Click.

Solicitud#



Requerido

PropiedadTipoDescripciónPredeterminadoValores posibles
subscriptionIdStringSubscriptionId que se creó previamente
callbackFunction(response)La función callback creada* Éxito : { token: "90a9f2d93ba508c38971890454897fd4"} * Error: { message:"error-message", code:"error-code", error: "error-message"}
amount (solo requerido para la autenticación 3DS)ObjectEl valor de la compra
currency (solo requerido para la autenticación 3DS)StringCódigo de la moneda usadaUSD, PEN

Respuesta#

La respuesta exitosa llegará en la función (callback):

{ 
  "token": "90a9f2d93ba508c38971890454897fd4"
}

La respuesta de error llegará en la función (callback):#

{ 
  "message":"error-message", 
  "code":"error-code",
  "error": "error-message" 
}

Ejemplos de dispersiones#

Cash Out

requestPayoutsCashToken()#

Para crear un token de Cash Out, puedes usar esta función:

Solicitud#



Requerido

PropiedadTipoDescripciónValores posibles
nameStringNombre del cliente
lastNameStringApellido del cliente
documentTypeStringTipo de documento con el que paga el cliente.CC, NIT, CE, TI, PP
documentNumberStringNúmero de documento con el que paga el cliente
totalAmountNumberEl monto que vas a cobrar, como número
currencyStringCódigo de la moneda usadaCOP
callbackFunction(response)La función callback creada* Éxito : { token: "90a9f2d93ba508c38971890454897fd4"} * Error: { message:"error-message", code:"error-code", error: "error-message"}

Opcional

PropiedadTipoDescripción
emailStringCorreo electrónico del cliente
paymentDescriptionStringUna descripción del pago

Respuesta#

La respuesta exitosa llegará en la función (callback):

{ 
    "token": "90a9f2d93ba508c38971890454897fd4"
}

La respuesta de error llegará en la función (callback):#

{ 
  "message":"error-message", 
  "code":"error-code",
  "error": "error-message"
}

Otros ejemplos#

Estado del gateway
Comisiones
Card Branding Animation

getStatusGateway()#

Para obtener el estado de todos los métodos de pago configurados para un comercio específico:

Solicitud#



Requerido

PropiedadTipoDescripción
callbackFunction(response)The created callback function()

Respuesta#

La respuesta llegará en la función (callback):

[
    {
      "card": true,
      "transfer": true,
      "cash": true
    }
]

Referencia#

Encuentra los métodos disponibles en nuestra librería Kushki.js. Puedes realizar las siguientes operaciones:
Pago único:
Crear un token de tarjeta
Solicitar una validación OTP. Si quieres más información sobre esta funcionalidad, ve a nuestra sección One Time Password
Obtener el JWT para integraciones 100% API con 3DS
Validar el challenge 3DS
Obtener las opciones de diferido por bin
Obtener la información del bin
Crear un token de Card Async
Obtener la lista de bancos disponibles para Transfer In
Crear un token de Transfer In
Crear un token de Cash In
Cargos recurrentes:
Crear un token de cargo recurrente con tarjeta
Obtener el JWT para integraciones 100% API con 3DS
Obtener el token de un cargo recurrente específico
Obtener un cargo recurrente con Async Card
Dispersiones:
Create a Cash Out token
Otros:
Obtener el estado de todos los métodos de pago configurados para un comercio específico
Obtener la información relacionada al cargo por comisión configurado para un comercio específico

Pago único#


NombreParámetrosDevuelveDescripción
requestToken()card, amount, currency, months, callbackObjectDevuelve un token de una tarjeta de crédito. Asegúrate de que estén fuera de tu formulario principal (PCI COMPLIANCE). Si el comercio tiene activada la validación OTP, este método también devuelve un secureId y un secureService que puedes usar luego para validar el OTP.
requestSecureServiceValidation()secureServiceId, otpValue, callbackObjectDevuelve si el OTP es válido o no.
requestSecureInit()card, callbackObjectEste método te permite obtener el Json Web token (JWT) para integraciones 100% API con 3DS.
requestValidate3DS()secureId, security, acsURL, authenticationTransactionId, specificationVersion, paReq, authRequired, callbackObjectEste método permite realizar la autenticación 3DS por parte del tarjetahabiente en caso de que sea requerida.
requestDeferred()binBody, callbackObjectDevuelve un objeto con las opciones de diferido permitidas para comercios ecuatorianos, mexicanos y peruanos.
requestBinInfo()binBody, callbackObjectDevuelve un objeto con la información relacionada al bin de la tarjeta de crédito.
requestCardAsyncToken()totalAmount, currency, returnUrl, email, description, callbackObjectDevuelve un token de card async
requestBankList()callbackObjectDevuelve la lista de bancos disponibles para Transfer In
requestTransferToken()bankId, amount, email, callbackUrl, documentType, documentNumber, currency, paymentDesc, userType, callbackObjectDevuelve un token de transfer in
requestTransferSubscriptionToken()email, callbackObjectDevuelve un token de transfer in (solo México)
requestCashToken()name, lastName,documentType, identification, email, totalAmount, currency,description, callbackObjectDevuelve un token de cash in

Cargos recurrentes#


NombreParámetrosDevuelveDescripción
requestSubscriptionToken()card, currency, callbackObjectDevuelve un token de un cargo recurrente. Asegúrate de que estén fuera de tu formulario principal (PCI COMPLIANCE).
requestSecureInit()card, callbackObjectEste método te permite obtener el Json Web token (JWT) para integraciones 100% API con 3DS.
requestValidate3DS()secureId, security, acsURL, authenticationTransactionId, specificationVersion, paReq, authRequired, callbackObjectEste método permite realizar la autenticación 3DS por parte del tarjetahabiente en caso de que sea requerida.
requestDeviceToken()subscriptionId, callbackObjectDevuelve el token de un cargo recurrente específico.
requestSubscriptionCardAsyncToken()currency, email, cardNumber, callbackUrl, callbackObjectDevuelve un token de cargo recurrente con card async.

Dispersiones#


NameParametersReturnsDescription
requestPayoutsCashToken()name, lastName,documentType, identification, email, totalAmount, currency,paymentDescription, callbackObjectReturns a cash out token

Otros#


NombreParámetrosDevuelveDescripción
getStatusGateway()callbackObjectDevuelve el estado de todos los métodos de pago configurados para un comercio específico
getCommissionConfiguration()totalAmount, currency, callbackObjectDevuelve la información relacionada al cargo por comisión configurado para un comercio específico
initCardBrandingAnimation()callback, constrained, color, sound, checkmarkObjectLa Card Branding Animation le da al usuario una confirmación clara de su pago.

¿Tienes una sugerencia sobre esta documentación? Contáctanos.
Modified at 2026-09-11 15:21:19
Previous
Configuración ARM de Kushki iOS
Next
kushki.js Hosted Fields
Built with