Desenvolvedores

    API-first,
    desde o primeiro dia

    Integre Akua em minutos com nossa API REST, SDKs em múltiplas linguagens, documentação completa e um ambiente de testes que simula produção real.

    Quick Start

    Primeiras transações em minutos

    Uma API REST simples e previsível com payloads JSON. Sem SDKs obrigatórios, funciona com qualquer linguagem.

    Autenticação com API keys
    Tratamento de erros consistente
    Paginação por cursor
    Idempotency keys nativo
    Rate limiting inteligente
    Versionamento semântico
    Ver documentação 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

    Sua linguagem, nossa biblioteca

    SDKs oficiais mantidos pela equipe Akua com suporte para as principais linguagens e 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 sem surpresas

    Um ambiente de testes que replica exatamente o comportamento de produção.

    Cartões de teste

    4000 0000 0000 0002

    Pagamento bem-sucedido

    Visa
    4000 0000 0000 0127

    Pagamento recusado

    Visa
    5200 8282 8282 8210

    3DS Challenge

    Mastercard
    4000 0000 0000 3220

    3DS Frictionless

    Visa
    Simule todos os métodos de pagamento da LATAM
    Configure respostas customizadas por cartão
    Webhooks em tempo real no sandbox
    Dashboard de testes com logs completos
    Dados de teste pré-carregados
    Reset do ambiente com um clique

    API Documentation

    Documentação completa da API REST com exemplos em múltiplas linguagens, schemas de resposta e códigos de erro.

    Ver docs

    SDKs & Libraries

    Bibliotecas oficiais para Node.js, Python, PHP, Java, Go, Ruby, iOS (Swift) e Android (Kotlin).

    Ver docs

    Webhooks

    Notificações em tempo real para todos os eventos: payment.succeeded, payment.failed, dispute.created, payout.completed e mais.

    Ver docs

    Testing Environment

    Sandbox completo com cartões de teste, simuladores de APMs, cenários de erro configuráveis e dados de teste realistas.

    Ver docs

    Integration Guides

    Guias passo a passo para as integrações mais comuns: checkout, assinaturas, pagamentos de marketplace e POS.

    Ver docs

    API Reference

    Referência técnica completa com todos os endpoints, parâmetros, tipos de dados e exemplos de request/response.

    Ver docs
    Quick Start

    Sua primeira transação em 3 passos

    Sem configurações complexas. A API da Akua foi projetada para que você possa ir de zero a produção em minutos.

    01

    Obtenha suas API keys

    Crie sua conta no sandbox da Akua. Você receberá uma API key de teste imediatamente — sem necessidade de aprovação.

    ak_test_abc123xyz...
    02

    Instale o SDK

    Disponível no npm, pip, composer, rubygems e mais. Ou use a API REST diretamente com qualquer cliente HTTP.

    npm install @akua/node
    03

    Crie seu primeiro pagamento

    Uma chamada à API. O sandbox simula o comportamento real de produção incluindo smart routing e webhooks.

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

    Eventos em tempo real para cada estado

    Notificações HTTP para cada mudança no ciclo de vida de um pagamento. Retentativas automáticas com backoff exponencial.

    payment.succeededPagamento concluído com sucesso
    payment.failedPagamento recusado ou falho
    payment.refundedReembolso processado
    dispute.createdNovo chargeback aberto
    payout.completedLiquidação concluída ao merchant
    merchant.approvedMerchant aprovado no 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 — Novo

    Integre Akua ao seu ambiente de IA agêntica com MCP.

    O MCP Server da Akua expõe todas as operações da API como ferramentas que qualquer agente de IA pode usar. Compatível com Claude, Cursor, Windsurf e qualquer ambiente que suporte Model Context Protocol.

    Crie payment links a partir de linguagem natural
    Consulte o status de transações e liquidações
    Gerencie merchants e configurações de terminal
    Gere relatórios analíticos conversacionalmente
    Controle granular de permissões por operação
    Rastreabilidade e auditoria completa de cada ação
    Documentação 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

    Precisa de ajuda
    com a integração?

    Nossa equipe de soluções técnicas está disponível para ajudá-lo com integrações complexas, arquiteturas enterprise e fluxos personalizados.