10 min

Quick Start

Do zero a primeira transacao orquestrada em 4 passos. Sem config complexa. Sem vendor lock-in.

Pre-requisitos

Node.js 18+, Python 3.9+, ou Go 1.21+
Conta Sentra com API key (sandbox gratuito)
Pelo menos um gateway configurado no dashboard

Obtenha suas credenciais

Crie uma conta na Sentra e gere suas API keys no dashboard.

Apos criar sua conta, va em Settings → API Keys e gere um par de chaves (sandbox e production).

.env

env

SENTRA_API_KEY=sk_sandbox_xxxxxxxxxxxxxxxx
SENTRA_API_URL=https://api.sentra.com.br/v1

Instale o SDK

Disponivel para Node.js, Python e Go.

Node.js

bash

npm install @sentra/sdk

Python

bash

pip install sentra-sdk

bash

go get github.com/sentra-io/sentra-go

Envie sua primeira transacao

Uma chamada. A Sentra decide o melhor gateway automaticamente.

checkout.ts

typescript

import { Sentra } from '@sentra/sdk';

const sentra = new Sentra({
  apiKey: process.env.SENTRA_API_KEY!,
});

// Envie uma transacao — Sentra roteia automaticamente
const transaction = await sentra.transactions.create({
  amount: 34990,          // centavos (R$ 349,90)
  currency: 'BRL',
  method: 'credit_card',
  card: {
    number: '4111111111111111',
    exp_month: 12,
    exp_year: 2027,
    cvv: '123',
    holder: 'Maria Santos',
  },
  metadata: {
    order_id: 'order_abc123',
    customer_email: 'maria@email.com',
  },
});

console.log(transaction.status);      // "approved"
console.log(transaction.gateway);     // "cielo" (escolhido pela Sentra)
console.log(transaction.latency_ms);  // 380

O que acontece: Sentra avalia todos os gateways conectados, aplica suas regras de routing (custo, latencia, disponibilidade), e roteia pro melhor caminho. Se o gateway escolhido falhar, faz failover automatico em <200ms.

Monitore no dashboard

Veja transacoes, aprovacao, latencia e economia em tempo real.

Acesse o Dashboard para ver suas transacoes fluindo em tempo real. Configure alertas para ser notificado quando um gateway degradar.

Transacoes

Real-time

→ /dashboard/transactions

Gateways

Health + metricas

→ /dashboard/gateways

Routing

Regras visuais

→ /dashboard/routing

Analytics

Custo + economia

→ /dashboard/analytics

Proximos passos

API Reference

Todos os endpoints documentados

Configurar routing rules

Otimize custo e aprovacao

import { Sentra } from '@sentra/sdk'; const sentra = new Sentra({ apiKey: process.env.SENTRA_API_KEY!, }); // Envie uma transacao — Sentra roteia automaticamente const transaction = await sentra.transactions.create({ amount: 34990, // centavos (R$ 349,90) currency: 'BRL', method: 'credit_card', card: { number: '4111111111111111', exp_month: 12, exp_year: 2027, cvv: '123', holder: 'Maria Santos', }, metadata: { order_id: 'order_abc123', customer_email: 'maria@email.com', }, }); console.log(transaction.status); // "approved" console.log(transaction.gateway); // "cielo" (escolhido pela Sentra) console.log(transaction.latency_ms); // 380