Choose a language. Until you change it, we suggest one from your region (Brazil → Portuguese, US/UK → English, Mexico/Argentina → Spanish).Start for free

Documentação

Integração de gateways de pagamento

A Etrovvo guarda as credenciais na tua organização (conta PSP em modo live) para processar checkout e reconciliar vendas. Usa apenas o que o painel de Pagamentos pede: não partilhes a tua sessão nem captures de ecrã com chaves visíveis.

Stripe
  1. Entra em Developers → API keys.
  2. Copia a Publishable key (pk_live_…) e a Secret key (sk_live_…). Na Etrovvo correspondem a “Publishable key” e “Secret key”.
  3. Para Connect / contas vinculadas, usa o fluxo “Ligar com Stripe” (OAuth) no painel da loja quando disponível.

Documentação oficial — API keys

PayPal
  1. Acede ao PayPal Developer Dashboard.
  2. Cria uma REST API app (Live) e obtém Client ID e Secret.
  3. Cola exactamente esses valores nos campos PayPal na Etrovvo.

PayPal REST apps

Mercado Pago
  1. Entra em Mercado Pago → Developers → Suas integrações (o domínio pode ser .com.ar / .commx conforme o país).
  2. Em Credenciais de produção, copia Access token e Public key.
  3. O User ID do vendedor aparece no painel da conta (necessário para algumas operações).

Docs Mercado Pago

PagSeguro / PagBank (Brasil)
  1. Acede à área de integrações / chaves da tua conta PagBank ou PagSeguro v4.
  2. Gera ou copia o token de autenticação usado pela API (conforme o produto contratado).
  3. Cola no campo de token na Etrovvo e guarda.

O nome exacto no painel pode variar (PagSeguro 4.0 vs PagBank). Em caso de dúvida, usa o suporte PagBank com “token de API de checkout”.

EBANX
  1. No EBANX Dashboard, entra na área de integração / API keys da tua conta.
  2. Copia a Integration key (e demais dados se o teu contrato exigir).
  3. Cole na Etrovvo no campo EBANX.

EBANX docs

Transbank Webpay Plus (Chile)

Campos necessários: Commerce Code, API Key, Environment

  1. Acesse transbankdevelopers.cl e crie uma conta.
  2. Para testes use as credenciais integration da documentação (Commerce Code 597055555532, API Key pública).
  3. Para produção, contrate Webpay Plus com a Transbank — receberás um Commerce Code e API Key Secret próprios.
  4. No painel da Etrovvo, cole Commerce Code, API Key e defina environment como integration (testes) ou production.

O Webpay Plus é redirect-based: o cliente é levado para o site da Transbank, autoriza o pagamento e volta para o teu return URL — fazemos o commit do token e marcamos o pedido como pago.

Docs Transbank Webpay Plus

Flow.cl (Chile)

Campos necessários: API Key, Secret Key

  1. Acesse flow.cl e crie uma conta de comerciante.
  2. Em "Mi cuenta" → "API", gere o par API Key + Secret Key.
  3. Cole os valores na Etrovvo. Cada chamada será assinada via HMAC-SHA256 antes de ser enviada a Flow.
  4. Configure o webhook em Flow apontando para {ORIGIN}/api/webhooks/payments/flow.

Docs Flow API

Payku (Chile)

Campos necessários: Public Token, Private Token

  1. Acesse app.payku.cl e crie uma conta empresarial.
  2. Em "Configuración" → "Integraciones", copie o Public Token e o Private Token.
  3. Cole os valores na Etrovvo. O Private Token só é usado no server-side (criação de transações e consulta de status).
  4. Configure o webhook em Payku apontando para {ORIGIN}/api/webhooks/payments/payku.

Docs Payku

Khipu (Chile)

Campos necessários: Receiver ID, Secret Key

  1. Acesse khipu.com e crie uma conta de cobrador.
  2. Em "Cuenta" → "Para integrar Khipu en tu sitio", copie o ID de cobrador e o Secret.
  3. Cole os valores na Etrovvo. Toda chamada é autenticada via header x-api-key + assinatura HMAC.
  4. Configure o webhook (notify_url) em Khipu apontando para {ORIGIN}/api/webhooks/payments/khipu.

Khipu funciona via "transferencia bancaria automatizada": o cliente é redirecionado ao banco para autorizar uma transferência. Bom para tickets altos e zero chargeback risk.

Docs Khipu API v3

As integrações são responsabilidade do comerciante: cumpre PCI e políticas de cada rede (por exemplo, não armazenares PAN em texto claro). Produção vs teste: na Etrovvo usamos contas em modo live para cobrar clientes finais.