Kushki Developer Portal
  1. Card Payouts Interface
Kushki Developer Portal
  • KUSHKI API
    • Kushki Developer Portal 🚀
    • Perú 🇵🇪
    • Ecuador 🇪🇨
    • Chile 🇨🇱
    • México 🇲🇽
    • Colombia 🇨🇴
    • Libraries & SDKs (Online Payments)
      • Release notes
      • Mobile
        • Kushki Android
        • Kushki iOS 
        • Kushki iOS ARM Setup
      • Web
        • Kushki.js 🌐
        • kushki.js-hosted-fields
          • kushki.js Hosted Fields
          • Guía de migración a Kushki.js 2.0
          • Javascript
          • Card Payouts
            • Interfaces
              • Interface `FormValidity`
              • Interface `Styles`
              • Interface `CardPayoutUniqueTokenResponse`
              • Interface `CardPayoutSubscriptionTokenResponse`
              • Interface `CardPayoutOptions`
              • Interface `Fields`
              • Interface `Field`
              • Interface `FieldValidity`
            • Type Aliases
              • Type Alias `InputTypeEnum`
              • Type Alias `CardPayoutTokenResponse`
            • Errors
              • Errors
            • Card Payouts Interface
              • Interface `ICardPayouts`
            • Enumerations
              • Enumeration `InputModelEnum`
            • Methods
              • initCardPayoutToken method
            • Types
              • Type Alias `CssProperties`
          • Antifraud
            • Interfaces
              • Untitled Doc
              • Untitled Doc
              • SiftScienceObject Interface
            • Methods
              • Untitled Doc
              • requestInitAntiFraud method
              • Untitled Doc
          • Kushki
            • Interfaces
              • Untitled Doc
              • CommissionConfigurationRequest interfaces
              • Untitled Doc
            • Classes
              • Untitled Doc
            • Methods
              • requestBankList function
              • requestCommissionConfiguration function
              • Kushki.js Hosted Fields init function
          • Card
            • Card-Interface
              • Untitled Doc
              • Untitled Doc
            • Interfaces
              • Untitled Doc
              • AppleTokenResponse Interface
              • Untitled Doc
              • Untitled Doc
              • BrandByMerchantResponse Interface
              • ApplePayOptions Interface
              • ApplePayPaymentContact Interface
              • ApplePayGetTokenOptions Interface
              • Untitled Doc
              • Untitled Doc
              • MasterCardBrandingRequest Interface
              • Untitled Doc
              • Untitled Doc
              • Untitled Doc
              • Untitled Doc
              • Untitled Doc
              • Untitled Doc
              • Untitled Doc
              • Untitled Doc
              • Untitled Doc
              • VisaBrandingRequest Interface
              • Untitled Doc
              • Untitled Doc
              • Untitled Doc
            • CarApplePay interface
              • ICardApplePay Interface
            • Errors
              • Untitled Doc
            • Methods
              • Untitled Doc
              • Untitled Doc
              • Untitled Doc
              • requestInitCardBrandingAnimation method
              • Untitled Doc
              • requestBrandsByMerchant method
            • Types
              • Untitled Doc
              • Untitled Doc
              • Untitled Doc
    • Schemas
      • webhooksChargeback
      • one-and-two-step-payment
      • webhooks
      • transactionType
      • threeDomainSecure
      • product
      • payment_submethod
      • paymentMethod
      • orderDetails
      • headers
      • extraTaxes
      • documentType
      • currency
      • currency-cash-in
      • currency-CL
      • binInfo
      • UnexpectedErrorResponse
      • SubscriptionUpdate
      • SubscriptionAdjustmentRequest
      • Subscription
      • Submerchant
      • Shipping-Address
      • Promotions
      • Metadata
      • Language
      • InvalidBinResponse
      • GetConfigurationRequest
      • ErrorResponse
      • Deferred
      • Country
      • ContactDetails
      • ChargesVoidCardResponse
      • Channel
      • Card
      • Billing-Address
      • BadRequestResponse
      • Amount
      • Amount-cash-in
      • Amount-CL
  • APPIAN-SUBMERCHANT-REGISTER
    • Submerchant Validation in Batch
    • Query submerchant status by requestId/submerchantId
    • Get submerchantIds
    • Get credentials for submerchants
  1. Card Payouts Interface

Interface `ICardPayouts`

This interface contains all the methods required to use initCardPayoutToken.

Methods#

Focus#

focus(fieldType): Promise<void>
Focuses a hosted field of the specified type.

Parameters#

fieldType: FieldTypeEnum – The field to focus.

Returns#

Promise<void> – Resolves when the field is focused.

Throws#

ERRORS.E010 – If an error occurs while focusing the field.

Example#


getFormValidity#

getFormValidity(): FormValidity
Returns the validation state of all fields.

Returns#

FormValidity – Object containing validation information.

Example#


onFieldBlur#

onFieldBlur(event, fieldType?): void
Emits an event when a field loses focus.

Parameters#

event: (fieldEvent) => void – Callback executed when a field is blurred.
fieldType?: FieldTypeEnum (optional) – Specifies which field to track. FormValidity | FieldValidity.
Returns void
(Optional) fieldType: FieldTypeEnum (optional) Set type of field if you want handle event blur and get FieldValidity of specific field.
Returns void

Example#

Handling event 'blur' to get specific FieldValidity

onFieldFocus#

onFieldFocus(event, fieldType?): void
Emits an event when a field gains focus.

Parameters#

event: (fieldEvent) => void – Callback executed when a field is focused.

(fieldEvent): void

Parameters

fieldEvent:FormValidity | FieldValidity.
Returns void
fieldType?: FieldTypeEnum (optional) – Specifies which field to track.
Returns void

Example#

Handling events 'focus' to get FormValidity
Handling event 'focus' to get specific hosted field FieldValidity

onFieldSubmit#

onFieldSubmit(event, fieldType?): void
Emits an event when a field is submitted.

Parameters#

event: (fieldEvent) => void – Callback is executed when some field is submitted

(fieldEvent): void

Parameters

fieldEvent:FormValidity | FieldValidity.
Returns void
fieldType?: FieldTypeEnum (optional) – Set type of field if you want handle event submit and get FieldValidity of specific field.
Returns void

Example#

Handling events 'submit' to get FormValidity
Handling event 'submit' to get FieldValidity of specific field.

onFieldValidity#

onFieldValidity(event, fieldType?): void
Emits an event when the field validity changes.

Parameters#

event: (fieldEvent) => void – Callback is executed when some field changes his validity

(fieldEvent): void

Parameters

fieldEvent:FormValidity | FieldValidity.
Returns void
fieldType?: FieldTypeEnum (optional) – Set type of field if you want handle event validity of specific hosted field
Returns void

Example#

Handling events 'FormValidity' of all hosted fields
Handling event 'FieldValidity' of cardNumber field

requestCardPayoutToken#

requestCardPayoutToken(): Promise<CardPayoutTokenResponse>
Gets a secure token or subscription ID for a card payout transaction.

Returns#

Promise<CardPayoutTokenResponse>
If isSubscription is checked, returns CardPayoutSubscriptionTokenResponse, otherwise returns CardPayoutUniqueTokenResponse.

Throws#

ERRORS.E002 – If there is an error requesting the payout token.
ERRORS.E007 – If any hosted field is invalid.

Example for one-time token#

Example for subscriptionId token#


reset#

reset(fieldType): Promise<void>
Resets a hosted field to its default state.

Parameters#

fieldType: FieldTypeEnum – The field to reset.

Returns#

Promise<void> – Resolves when the field is reset.

Throws#

ERRORS.E009 – If an error occurs while resetting the field.

Example#

Modified at 2026-02-02 22:10:25
Previous
Errors
Next
Enumeration `InputModelEnum`
Built with