Guides
Status PageDashboardBook a Demo

Kushki - Cards

Suggest Edits

This page presents all information related to the Kushki connection using Cards as payment. Use the following buttons to navigate to the desired section.

General Information

Captures

Refunds

Voids

Installments

Chargebacks

Security

Testing Guidelines

Integration Configuration

Production Environment

Connecting with Yuno

Mandatory fields when integrating via Yuno:

first_name
last_name
email
document_type
document_number
telephone_number
*The provider may request additional fields according to the merchant or to improve the approval rate.

General information

Countries:

Chile-flag
Chile
Colombia-flag
Colombia
ecuador-flag
Ecuador
mexico-flag
Mexico
peru-flag
Peru

Currencies:

CLP, COP, USD, MXN, PEN

Payment methods:

Credit card
Credit card
debit card
Debit card

Minimum amount:

Chile: 50 CLP
Colombia: 500 COP
Ecuador: 1.15 USD
Mexico: 1 MXN
Peru: 1 PEN

Maximum amount:

Dependent on cardholder's limit.

TRX limit:

Scalabale architecture to cover demand, limited by the capacity of the processors we work with.

Support of international BIN:

Yes

Activation of functionality:

Communicate with your TAM for more information on how to do it.

TRX without CVV:

Yes, communicate with Kushki to activate the functionality.

Purchase TRX in 1-Step:

Yes

Purchase TRX in 2-Step:

Chile: Supported. *Mastercard and Visa cards do not accept authorization and capture, partial capture, refunds or partial reimbursements.
Colombia: Not Supported.
Ecuador: Not Supported.
Mexico: Supported.
Peru: Supported. *Mastercard debit cards don't allow authorization and capture or partial capture.

Support for recurrency:

Yes

Webhooks:

Yes

Captures

Partial capture:

Chile: Supported
Colombia: Not Supported
Ecuador: Not Supported
Mexico: Not Supported
Peru: Supported

Multiple captures:

Chile: Supported
Colombia: Not Supported
Ecuador: Not Supported
Mexico: Not Supported
Peru: Not Supported

Maximum time to capture an authorization:

Chile: 7 days
Colombia: Not Supported
Ecuador: Not Supported
Mexico: 9 days
Peru: 7 days

Captures over the amount of authorization:

Chile: Not Supported
Colombia: Not Supported
Ecuador: Not Supported
Mexico: Not Supported
Peru: Supported

Maximum amount:

20% above the authorized amount in the supported countries.

Refunds

Refund support:

Yes

Partial refunds:

Chile: Supported
Colombia: Supported
Ecuador: Not Supported
Mexico: Supported
Peru: Supported

Multiple refunds:

Chile: Supported
Colombia: Supported
Ecuador: Not Supported
Mexico: Supported
Peru: Supported

Time to request refund:

Chile: 3 months
Colombia: 6 months
Ecuador: 6 months
Mexico: 30 days
Peru: 6 months

Time to process refund:

7 days

Voids

Void support:

Yes

Void to authorization:

Yes

Void to refund:

No

Installments

Capability to define the installments when creating the payment:

Yes. The structure for Colombia and Peru is different from Ecuador and Mexico.

GET endpoint available for retrieving the permitted BIN for the installments:

Yes

Possibility to choose who will be responsible for financing installments:

No

Conditions or restrictions:

There are installment plans for Ecuador and Mexico.

Deferral date availability:

Yes

Grace period:

Yes

Minimum number of Installments (#months):

Chile: 1
Colombia: 1
Ecuador: According to an agreement between the merchant and Kushki. This can be checked on the merchant's dashboard.
Mexico: According to an agreement between the merchant and Kushki. This can be checked on the merchant's dashboard.
Peru: 1

Maximum number of Installments (#months):

Chile: 48
Colombia: 48
Ecuador: According to an agreement between the merchant and Kushki. This can be checked on the merchant's dashboard.
Mexico: According to an agreement between the merchant and Kushki. This can be checked on the merchant's dashboard.
Peru: 48

Chargebacks

Notifications of chargebacks:

Yes

Defined period to make a chargeback:

90 days.

Endpoint for disputes:

Yes

Maximum time to dispute a chargeback (provide evidence):

72 working hours.

Security

E3DS v2:

Yes, for Mexico and Peru.

Testing guidelines for sandbox environment

Necessary fields for testing:

Llave Pública, Llave Privada and Webhook Signature.

Test cards:

Card Numbers:
  • Approved transaction: 5451951574925480
  • Declined transaction in token solicitation: 4574441215190335
  • Rejected transaction in payment request: 4349003000047015
  • Invalid card: 4349008516656431
  • Card with no funds: 4349001210846432
  • Invalid CVV: 4349003243371321
  • Blocked card: 4349001386781322

Limitations/Specifications for testing:

CVV and ZIP Code in test cards can have any value. Expiration date can be any date in the future.
Kushki allows simulating an approved OTP validation. Use the following values depending on the currency that belongs to your credentials:
  • CLP: 150
  • COP: 555
  • USD: 155
  • PEN: 155
  • MXN: 555
*Any other OTP value will result in a declined validation.

Integration configuration

Credentials and steps to obtain them:

  1. Log in to Kushki dashboard (there is a testing dashboard and production dashboard).
  2. Go to Desarrolladores section.
  3. Go to Credenciales section.
  4. Copy the values under the Llave pública and Llave privada column.
  5. Click Connect.

Dashboard configuration:

  1. Log in to dashboard.y.uno.
  2. Click Connections and then select Kushki.
  3. Click Connect.
  4. Introduce Llave pública,Llave privada, and Webhook Signature.
  5. Click Connect.

Configuration of webhooks in partner:

Share the Merchant ID (ID de Comercio) with your TAM in order to setup yours webhook notifications. How to get your Merchant ID:
  1. Log in to Kushki dashboard (there is a testing dashboard and production dashboard)
  2. Go to Mi Comercio.
  3. Copy the value on the right top corner under the legend ID de Comercio.

Production environment

Specific procedure for a merchant to go live:

Verification of the flow with the commerce using real transactions.


Send feedback

Updated about 2 months ago