Developers

    API-first,
    from day one

    Integrate Akua in minutes with our REST API, SDKs in multiple languages, comprehensive documentation, and a testing environment that simulates real production.

    Quick Start

    First transactions in minutes

    A simple and predictable REST API with JSON payloads. No mandatory SDKs, works with any language.

    API key authentication
    Consistent error handling
    Cursor pagination
    Native idempotency keys
    Intelligent rate limiting
    Semantic versioning
    View full documentation
    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

    Your language, our library

    Official SDKs maintained by the Akua team with support for major languages and 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

    Complete sandbox no surprises

    A test environment that exactly replicates production behavior.

    Test cards

    4000 0000 0000 0002

    Successful payment

    Visa
    4000 0000 0000 0127

    Declined payment

    Visa
    5200 8282 8282 8210

    3DS Challenge

    Mastercard
    4000 0000 0000 3220

    3DS Frictionless

    Visa
    Simulate all LATAM payment methods
    Configure custom responses per card
    Real-time webhooks in sandbox
    Testing dashboard with complete logs
    Pre-loaded test data
    One-click environment reset

    API Documentation

    Complete REST API documentation with examples in multiple languages, response schemas, and error codes.

    View docs

    SDKs & Libraries

    Official libraries for Node.js, Python, PHP, Java, Go, Ruby, iOS (Swift), and Android (Kotlin).

    View docs

    Webhooks

    Real-time notifications for all events: payment.succeeded, payment.failed, dispute.created, payout.completed, and more.

    View docs

    Testing Environment

    Complete sandbox with test cards, APM simulators, configurable error scenarios, and realistic test data.

    View docs

    Integration Guides

    Step-by-step guides for the most common integrations: checkout, subscriptions, marketplace payments, and POS.

    View docs

    API Reference

    Complete technical reference with all endpoints, parameters, data types, and request/response examples.

    View docs
    Quick Start

    Your first transaction in 3 steps

    No complex configurations. Akua's API is designed so you can go from zero to production in minutes.

    01

    Get your API keys

    Create your account in Akua's sandbox. You'll receive a test API key immediately — no approval required.

    ak_test_abc123xyz...
    02

    Install the SDK

    Available on npm, pip, composer, rubygems, and more. Or use the REST API directly with any HTTP client.

    npm install @akua/node
    03

    Create your first payment

    One API call. The sandbox simulates real production behavior including smart routing and webhooks.

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

    Real-time events for every state

    HTTP notifications for every change in a payment's lifecycle. Automatic retries with exponential backoff.

    payment.succeededPayment completed successfully
    payment.failedPayment declined or failed
    payment.refundedRefund processed
    dispute.createdNew chargeback opened
    payout.completedSettlement completed to merchant
    merchant.approvedMerchant approved in 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 — New

    Integrate Akua into your agentic AI environment with MCP.

    Akua's MCP Server exposes all API operations as tools that any AI agent can use. Compatible with Claude, Cursor, Windsurf, and any environment that supports Model Context Protocol.

    Create payment links from natural language
    Query transaction and settlement status
    Manage merchants and terminal configurations
    Generate analytical reports conversationally
    Granular permission control per operation
    Complete traceability and audit of every action
    MCP Documentation
    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

    Need help
    with the integration?

    Our technical solutions team is available to help you with complex integrations, enterprise architectures, and custom flows.