Primeiro pagamento em 5 minutos

Em cinco passos você cria uma cobrança de teste, simula o pagamento e recebe o webhook. Nada aqui movimenta dinheiro real.

1. Crie a conta e uma chave de sandbox

Crie a conta em app.uneway.pro e aguarde a aprovação do cadastro pela equipe (antes disso o painel e a API respondem 403 account_pending_approval). No painel, abra Desenvolvedores → Chaves de API → Nova chave, escolha Sandbox e copie a chave uw_test_.... Ela aparece uma única vez.

2. Teste a autenticação

curl https://api.uneway.pro/api/v1/developer/me \
  -H "Authorization: Bearer uw_test_SUA_CHAVE"

A resposta mostra a conta, "livemode": false e os escopos da chave.

3. Crie uma cobrança

curl -X POST https://api.uneway.pro/api/v1/payments/europix \
  -H "Authorization: Bearer uw_test_SUA_CHAVE" \
  -H "Idempotency-Key: pedido-2001" \
  -H "Content-Type: application/json" \
  -d '{"order_id":"pedido-2001","amount":49.90,"customer_email":"ana@exemplo.com"}'

import { Uneway } from '@uneway/node';

const uneway = new Uneway(process.env.UNEWAY_API_KEY);
const pix = await uneway.payments.create('europix', {
  order_id: 'pedido-2001',
  amount: 49.90,
}, { idempotencyKey: 'pedido-2001' });

$uneway = new \Uneway\Client(getenv('UNEWAY_API_KEY'));
$pix = $uneway->payments->create('europix', [
    'order_id' => 'pedido-2001',
    'amount' => 49.90,
], ['idempotency_key' => 'pedido-2001']);

Em sandbox a cobrança é simulada: nenhum provedor é chamado e nenhum valor é cobrado. Use o seu próprio order_id no lugar de pedido-2001: ele precisa ser único na sua conta.

4. Simule o pagamento

curl -X POST https://api.uneway.pro/api/v1/developer/payments/pedido-2001/simulate \
  -H "Authorization: Bearer uw_test_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"status":"paid"}'

5. Receba o webhook

Cadastre a URL em Webhooks no painel. A simulação dispara payment.paid assinado com o seu segredo; confira a assinatura como em Webhooks e libere o pedido. Use Enviar evento de teste no painel para testar a URL a qualquer momento.

Quer o caminho completo com scripts prontos (Node e PHP)? Veja Integre em 10 minutos.

Indo para produção

• Com a conta aprovada e o e-mail confirmado, crie uma chave Produção (uw_live_) só com os escopos necessários.
• Troque a chave no servidor e mantenha o Idempotency-Key em todas as criações.