Kushki - Cards
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:
last_name
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:
Currencies:
CLP, COP, USD, MXN, PEN
Payment methods:
Minimum amount:
Colombia: 500 COP
Ecuador: 1.15 USD
Mexico: 1 MXN
Peru: 1 PEN
Maximum amount:
Dependent on cardholder's limit.
TRX limit:
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:
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:
Test cards:
- 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:
- CLP: 150
- COP: 555
- USD: 155
- PEN: 155
- MXN: 555
Integration configuration
Credentials and steps to obtain them:
- Log in to Kushki dashboard (there is a testing dashboard and production dashboard).
- Go to Desarrolladores section.
- Go to Credenciales section.
- Copy the values under the Llave pública and Llave privada column.
- Click Connect.
Dashboard configuration:
- Log in to dashboard.y.uno.
- Click Connections and then select Kushki.
- Click Connect.
- Introduce Llave pública,Llave privada, and Webhook Signature.
- Click Connect.
Configuration of webhooks in partner:
- Log in to Kushki dashboard (there is a testing dashboard and production dashboard)
- Go to Mi Comercio.
- Copy the value on the right top corner under the legend ID de Comercio.
Production environment
Specific procedure for a merchant to go live:
Updated 13 days ago