Desarrolladores

    API-first,
    desde el día uno

    Integra Akua en minutos con nuestra API REST, SDKs en múltiples lenguajes, documentación completa y un ambiente de testing que simula producción real.

    Quick Start

    Primeras transacciones en minutos

    Una API REST simple y predecible con payloads JSON. Sin SDKs obligatorios, funciona con cualquier lenguaje.

    Autenticación con API keys
    Manejo de errores consistente
    Paginación por cursor
    Idempotency keys nativo
    Rate limiting inteligente
    Versioning semántico
    Ver documentación completa
    payment.ts
    import Akua from '@akua/node';

const akua = new Akua({
  apiKey: process.env.AKUA_SECRET_KEY,
  environment: 'production'
});

const payment = await akua.payments.create({
  amount: 150000,
  currency: 'COP',
  payment_method: 'pm_card_123',
  customer: 'cus_abc456',
  routing: { strategy: 'smart' }
});

console.log(payment.status); // 'succeeded'
    SDKs & Libraries

    Tu lenguaje, nuestra librería

    SDKs oficiales mantenidos por el equipo de Akua con soporte para los principales lenguajes y frameworks.

    Node.js

    v2.4.1
    npm i @akua/node

    Python

    v1.8.0
    pip install akua

    PHP

    v1.5.2
    composer require akua/akua-php

    Java

    v2.1.0
    io.akua:akua-java:2.1.0

    Go

    v1.3.0
    go get github.com/akua-la/akua-go

    Ruby

    v1.2.1
    gem install akua

    iOS (Swift)

    v3.0.0
    pod "AkuaSDK"

    Android

    v3.0.0
    io.akua:android-sdk:3.0.0
    Testing Environment

    Sandbox completo sin sorpresas

    Un ambiente de prueba que replica exactamente el comportamiento de producción.

    Tarjetas de prueba

    4000 0000 0000 0002

    Pago exitoso

    Visa
    4000 0000 0000 0127

    Pago declinado

    Visa
    5200 8282 8282 8210

    3DS Challenge

    Mastercard
    4000 0000 0000 3220

    3DS Frictionless

    Visa
    Simula todos los métodos de pago de LATAM
    Configura respuestas custom por tarjeta
    Webhooks en tiempo real en sandbox
    Dashboard de testing con logs completos
    Datos de prueba pre-cargados
    Reset de ambiente con un click

    API Documentation

    Documentación completa de la API REST con ejemplos en múltiples lenguajes, esquemas de respuesta y códigos de error.

    Ver docs

    SDKs & Libraries

    Librerías oficiales para Node.js, Python, PHP, Java, Go, Ruby, iOS (Swift) y Android (Kotlin).

    Ver docs

    Webhooks

    Notificaciones en tiempo real para todos los eventos: payment.succeeded, payment.failed, dispute.created, payout.completed y más.

    Ver docs

    Testing Environment

    Sandbox completo con tarjetas de prueba, simuladores de APMs, escenarios de error configurables y datos de prueba realistas.

    Ver docs

    Integration Guides

    Guías paso a paso para las integraciones más comunes: checkout, suscripciones, marketplace payments y POS.

    Ver docs

    API Reference

    Referencia técnica completa con todos los endpoints, parámetros, tipos de datos y ejemplos de request/response.

    Ver docs
    Quick Start

    Tu primera transacción en 3 pasos

    Sin configuraciones complejas. La API de Akua está diseñada para que puedas ir de cero a producción en minutos.

    01

    Obtén tus API keys

    Crea tu cuenta en el sandbox de Akua. Recibirás un API key de prueba de inmediato — no requiere aprobación.

    ak_test_abc123xyz...
    02

    Instala el SDK

    Disponible en npm, pip, composer, rubygems y más. O usa la REST API directamente con cualquier cliente HTTP.

    npm install @akua/node
    03

    Crea tu primer pago

    Una llamada a la API. El sandbox simula el comportamiento real de producción incluyendo smart routing y webhooks.

    akua.payments.create({...})
    Webhooks

    Eventos en tiempo real para cada estado

    Notificaciones HTTP para cada cambio en el ciclo de vida de un pago. Reintentos automáticos con backoff exponencial.

    payment.succeededPago completado exitosamente
    payment.failedPago rechazado o fallido
    payment.refundedReembolso procesado
    dispute.createdNuevo chargeback abierto
    payout.completedLiquidación completada al merchant
    merchant.approvedMerchant aprobado en onboarding
    webhook-handler.ts
    app.post('/webhooks/akua', (req, res) => {
  const sig = req.headers['akua-signature'];

  // Verify signature
  const event = akua.webhooks.verify(
    req.body, sig, process.env.AKUA_WEBHOOK_SECRET
  );

  switch (event.type) {
    case 'payment.succeeded':
      fulfillOrder(event.data.metadata.order_id);
      break;
    case 'dispute.created':
      alertTeam(event.data.payment_id);
      break;
  }

  res.json({ received: true });
});
    MCP Server — Nuevo

    Integra Akua en tu entorno de IA agéntica con MCP.

    El MCP Server de Akua expone todas las operaciones de la API como herramientas que cualquier agente de IA puede usar. Compatible con Claude, Cursor, Windsurf y cualquier entorno que soporte Model Context Protocol.

    Crea payment links desde lenguaje natural
    Consulta el estado de transacciones y liquidaciones
    Gestiona merchants y configuraciones de terminal
    Genera reportes analíticos conversacionalmente
    Control granular de permisos por operación
    Trazabilidad y auditoría completa de cada acción
    Documentación MCP
    terminal
    # Install Akua MCP Server
$ npx akua-mcp

# Configure in Claude Desktop
# ~/.claude/claude_desktop_config.json
{
  "mcpServers": {
    "akua": {
      "command": "npx",
      "args": ["akua-mcp"],
      "env": {
        "AKUA_API_KEY": "ak_live_..."
      }
    }
  }
}

# Now in Claude:
"Generate a payment link for $50 USD"
→ https://pay.akua.la/l/abc123

    ¿Necesitas ayuda
    con la integración?

    Nuestro equipo de soluciones técnicas está disponible para ayudarte con integraciones complejas, arquitecturas enterprise y flujos personalizados.