1. Methods
Español
  • English
  • Español
  • Inicio
  • Integración con MCP
  • 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 🇨🇱
  1. Methods

initCardPayoutToken

Introducción#

Inicializa una instancia de ICardPayouts.

Parámetros#

kushkiInstance: IKushki
Un objeto que implementa IKushki.
options: CardPayoutOptions
Debes definir la configuración de los campos de Card Payouts
Tipo de pago (opcional): Define el tipo de pago. El valor por defecto es undefined. Longitud máxima: 2.
Ejemplo: ejemplo aquí.
Evitar autocompletado (opcional): Evita el autocompletado de los campos. El valor por defecto es false.
Ejemplo: ejemplo aquí.
Configurar campos personalizados: Permite personalizar campos específicos.
Ejemplo: ejemplo aquí.
Configurar estilos personalizados: Habilita los estilos personalizados para los campos.
Ejemplo: ejemplo aquí.

Devuelve#

Promise - instance of ICardPayouts.

Lanza#

Si los parámetros options o kushkiInstance son null o undefined, se lanza el error ERRORS.E012.
Si la propiedad options.paymentType tiene una longitud inválida, se lanza el error ERRORS.E011.
Si algún campo dentro de options.fields tiene un selector que no existe, se lanza el error ERRORS.E013.
Si options.fields no contiene los campos requeridos para el token de Card Payouts, se lanza el error ERRORS.E020.

Ejemplos#

Token de Card Payout básico#

Define los contenedores para los hosted fields#

Inicializa la instancia del token de Card Payout#

En segundo plano, este método renderiza los hosted fields.

Token de Card Payout con isSubscription obligatorio#

Configuración para el campo isSubscription obligatorio#

Para indicar si el hosted field isSubscription es obligatorio, agrega la bandera isRequired a la configuración de isSubscription. El valor por defecto es false.
Si el campo isSubscription es obligatorio, al llamar al método requestToken debes marcar el checkbox isSubscription. De lo contrario, se lanza un error.
Si el campo isSubscription no es obligatorio, marcar el checkbox isSubscription es opcional.

Token de Card Payout con el campo isSubscription omitido#

Configuración para el campo isSubscription omitido#

Para omitir el hosted field isSubscription, simplemente elimina su configuración.
Si falta la configuración de isSubscription, el checkbox isSubscription no se renderiza en la página.
El valor por defecto del checkbox isSubscription es false.

Ejemplo de opciones#

Usa la misma metodología de estilos personalizados que en Card Token Styles, pero aplica los estilos a los hosted fields de dispersión.
La bandera preventAutofill sirve para habilitar o deshabilitar el autocompletado con los datos guardados del navegador.
El valor de paymentType se envía en la solicitud del token y debe tener solo dos caracteres.
Para Visa y Mastercard, el valor aceptado de paymentType es "GP". Para otras marcas, revisa la lista de valores permitidos.
Modified at 2026-09-10 19:19:20
Previous
Interfaz `Styles`
Next
CardPayoutTokenResponse
Built with