Kushki API — Colombia 🇨🇴#
The Kushki API lets you integrate a full suite of payment solutions into your business. It follows REST principles — resource-oriented URLs, JSON-encoded responses, standard HTTP verbs and status codes.Before you start: request your sandbox credentials (Public-Merchant-Id and Private-Merchant-Id) from the Kushki Console. All requests must be made over HTTPS and include your credentials in the request headers.
Base URLs#
| Environment | URL |
|---|
| Production | https://api.kushkipagos.com |
| UAT (Sandbox) | https://api-uat.kushkipagos.com |
Authentication#
The API uses two types of keys:Public key (Public-Merchant-Id) — used to request tokens and query public information. Safe to use client-side.
Private key (Private-Merchant-Id) — used to execute charges, voids, refunds, and other sensitive operations. Never expose this key client-side.
Available Payment Methods#
Online Payments#
| Product | Description |
|---|
| Card | One-time charges, deferred payments, pre-authorization, capture, tokenless payments |
| Transfer In | Bank transfers — customers pay directly from their bank account |
| Cash In | Cash payments at physical collection points |
Payouts#
| Product | Description |
|---|
| Transfer Out | Disbursements to bank accounts |
| Cash Out | Cash disbursements at collection points |
Recurring Payments#
| Product | Description |
|---|
| Subscriptions | Scheduled and one-click card charges |
| Card Async Recurring | Asynchronous recurring charges |
| Product | Description |
|---|
| Smart Links | Shareable payment links |
| Payment Button | Embeddable checkout button |
| Payment Credentials | Manage merchant sub-credentials |
HTTP Status Codes#
| Range | Meaning |
|---|
2xx | Request succeeded |
4xx | Client error — check request parameters |
5xx | Server-side error (rare) |
Idempotency#
To safely retry failed requests without risk of duplicate charges, include the Idempotency-Key header with a unique value (UUID v4 recommended).Valid for 24 hours after the first successful request
Must be unique per transaction type
Got a suggestion on this documentation? Contact us
Modified at 2026-07-01 15:33:46
