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▼
- Entra em Developers → API keys.
- Copia a Publishable key (pk_live_…) e a Secret key (sk_live_…). Na Etrovvo correspondem a “Publishable key” e “Secret key”.
- Para Connect / contas vinculadas, usa o fluxo “Ligar com Stripe” (OAuth) no painel da loja quando disponível.
PayPal▼
- Acede ao PayPal Developer Dashboard.
- Cria uma REST API app (Live) e obtém Client ID e Secret.
- Cola exactamente esses valores nos campos PayPal na Etrovvo.
Mercado Pago▼
- Entra em Mercado Pago → Developers → Suas integrações (o domínio pode ser .com.ar / .commx conforme o país).
- Em Credenciais de produção, copia Access token e Public key.
- O User ID do vendedor aparece no painel da conta (necessário para algumas operações).
PagSeguro / PagBank (Brasil)▼
- Acede à área de integrações / chaves da tua conta PagBank ou PagSeguro v4.
- Gera ou copia o token de autenticação usado pela API (conforme o produto contratado).
- 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▼
- No EBANX Dashboard, entra na área de integração / API keys da tua conta.
- Copia a Integration key (e demais dados se o teu contrato exigir).
- Cole na Etrovvo no campo EBANX.
Transbank Webpay Plus (Chile)▼
Campos necessários: Commerce Code, API Key, Environment
- Acesse transbankdevelopers.cl e crie uma conta.
- Para testes use as credenciais integration da documentação (Commerce Code
597055555532, API Key pública). - Para produção, contrate Webpay Plus com a Transbank — receberás um Commerce Code e API Key Secret próprios.
- No painel da Etrovvo, cole Commerce Code, API Key e defina environment como
integration(testes) ouproduction.
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.
Flow.cl (Chile)▼
Campos necessários: API Key, Secret Key
- Acesse flow.cl e crie uma conta de comerciante.
- Em "Mi cuenta" → "API", gere o par API Key + Secret Key.
- Cole os valores na Etrovvo. Cada chamada será assinada via HMAC-SHA256 antes de ser enviada a Flow.
- Configure o webhook em Flow apontando para
{ORIGIN}/api/webhooks/payments/flow.
Payku (Chile)▼
Campos necessários: Public Token, Private Token
- Acesse app.payku.cl e crie uma conta empresarial.
- Em "Configuración" → "Integraciones", copie o Public Token e o Private Token.
- Cole os valores na Etrovvo. O Private Token só é usado no server-side (criação de transações e consulta de status).
- Configure o webhook em Payku apontando para
{ORIGIN}/api/webhooks/payments/payku.
Khipu (Chile)▼
Campos necessários: Receiver ID, Secret Key
- Acesse khipu.com e crie uma conta de cobrador.
- Em "Cuenta" → "Para integrar Khipu en tu sitio", copie o ID de cobrador e o Secret.
- Cole os valores na Etrovvo. Toda chamada é autenticada via header
x-api-key+ assinatura HMAC. - 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.
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.

