1. Home
Español
  • English
  • Español
  • Inicio
  • Integración con MCP
  • Cómo usar API Docs
  • 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 🇨🇱
Status
Soporte / Support
Español
  • English
  • Español
  1. Home

Cómo usar API Docs

API Docs · Guía rápida
Cómo usar esta documentación
Prueba endpoints desde la página, copia código que funciona y conecta tu asistente de IA. Aquí verás qué hace cada herramienta y cuándo usarla.
En esta guía:Try itEjemplos de códigoAmbientesExport a PostmanMCP

Qué encontrarás en cada página de endpoint#

Todas las páginas de endpoint tienen la misma estructura. Los marcadores de la página de ejemplo coinciden con la lista de abajo.
api-docs.kushkipagos.com/…/request-a-card-tokenMCP7
Card Payments / TokensCopy Page ▾1
Request a card token
AmbienteUAT Testing Env ▾
POST/card/v1/tokensTry it2▷ Run in Apidog3
Body ParamsGenerate schema code5
cardobjectrequerido
totalAmountnumberrequerido
currencystringrequerido
ShellJavaScriptJava4
Ejemplo de petición
LLMs.txtCloneExport6
1
Copy Page, Markdown e IA
Copia la página como Markdown, vela como texto plano o ábrela en ChatGPT o Claude para preguntarle sobre ella.
Úsalo · Cuando quieras que un asistente de IA te explique un endpoint o escriba código a partir de él.
2
Try it
Envía una petición real al ambiente de pruebas desde la propia página, sin escribir código.
Úsalo · Para comprobar que tus llaves y tu petición funcionan antes de programar.
3
Run in Apidog
Abre el endpoint en la app de Apidog para seguir probándolo allí.
Úsalo · Si quieres guardar peticiones y armar tu propia colección.
4
Ejemplos de código
Peticiones listas para copiar en varios lenguajes: Shell, JavaScript, Java y más.
Úsalo · Como punto de partida de tu integración.
5
Generate schema code
Genera el modelo de datos de la petición o la respuesta en el lenguaje que elijas, por ejemplo TypeScript.
Úsalo · Para tener modelos tipados en lugar de escribirlos a mano.
6
Export, Clone y LLMs.txt
Export descarga la documentación como OpenAPI (3.1, 3.0 o Swagger 2.0), HTML, Markdown o formato Apidog. Clone la copia a tu proyecto de Apidog. LLMs.txt es el índice de toda la documentación para herramientas de IA.
Úsalo · Usa Export para importar la API en Postman u otra herramienta.
7
MCP
Conecta tu asistente de IA (Claude, Cursor, VS Code y otros) con la documentación oficial de Kushki para que responda con los endpoints vigentes. Ver MCP Integration.
Úsalo · Si desarrollas con un asistente de IA. No requiere credenciales de Kushki.

Elige el ambiente correcto#

El selector que está sobre el endpoint define a dónde envía la petición Try it. Cambia según el producto y cada ambiente tiene sus propias credenciales: elige el que corresponde a la página en la que estás.
UAT Testing EnvPruebas
Pruebas de Online Payments y de la mayoría de las APIs de Kushki. Es el ambiente por defecto.
https://api-uat.kushkipagos.com
API — ProducciónDinero real
Transacciones reales. Úsalo solo después de la certificación y con credenciales de producción.
https://api.kushkipagos.com
Kushki ONE Cloud — UATPruebas
Pruebas de Kushki ONE (terminales) a través de la nube.
https://uat-cloudt.kushkipagos.com
Kushki ONE Cloud — ProducciónDinero real
Kushki ONE en producción, a través de la nube.
https://cloudt.kushkipagos.com
Kushki ONE LocalPruebas
Comunicación con una terminal de tu red local. Reemplaza {{terminalIp}} y {{port}} con los valores de tu terminal.
http://{{terminalIp}}:{{port}}
Appian — UATPruebas
Pruebas de los endpoints de Appian.
https://core-uat-us-east-1.kushkipagos.com
Billpocket — Legacy v2 / E-commerce FlexPruebas
Productos de Billpocket. Tienen credenciales propias: las llaves de Kushki no funcionan aquí.
Verifica el ambiente antes de pulsar Send
Si el endpoint es de Kushki ONE, Appian o Billpocket, el selector debe mostrar su propio ambiente. Una petición enviada al ambiente equivocado falla o nunca llega al producto.

Prueba la API con Try it en 4 pasos#

1
Revisa el ambiente
Asegúrate de que el selector muestre el ambiente de pruebas de tu producto. Para Online Payments es UAT Testing Env: no se mueve dinero real.
2
Agrega tus credenciales
Pega tu Public Key en el header Public-Merchant-Id. Los endpoints que cobran o reembolsan usan tu Private Key en Private-Merchant-Id; la página indica cuál necesita.
3
Revisa el body y pulsa Send
El body de ejemplo ya trae datos de prueba. Puedes editarlo o enviarlo tal cual.
4
Lee la respuesta
Una petición exitosa devuelve 201 y el cuerpo de la respuesta, por ejemplo un token. Si hay un error, verás su código y mensaje para corregir la petición.
¿Dónde encuentro mis llaves?
En tu Consola de Kushki, dentro de la sección Credenciales. Aparecen como Public Key y Private Key. Usa credenciales de pruebas en Try it y nunca compartas tu Private Key ni una pantalla donde se vea.

Usa la API en Postman#

1.
Pulsa Export al final de cualquier página de endpoint.
2.
Elige OpenAPI Spec (versión 3.1 o 3.0) y pulsa Export.
3.
En Postman, elige Import y selecciona el archivo descargado.

Lee cualquier página como Markdown#

Agrega .md al final de la dirección de cualquier página para obtener su contenido como texto plano. El índice completo está en /llms.txt.

Quiero…#

Probar una petición sin escribir códigoTry it
Obtener un fragmento que funcioneEjemplos de código
Preguntarle a una IA sobre la APICopy PageOpen in ClaudeMCP
Usar la API en Postman u otra herramientaExport (OpenAPI)
Integrar con una libreríaLibrerías (SDKs)
¿Necesitas ayuda?
Nuestro equipo te acompaña en cada paso de tu integración.
Ver MCP IntegrationCentro de soporte ↗
Modified at 2026-10-16 21:32:00
Previous
Integración con MCP
Next
Libraries & SDKs (Online Payments)
Built with