Passo 1: Criar sua conta
Primeiro, crie sua conta no dashboard:
Criar Conta
Cadastre-se gratuitamente
Passo 2: Gerar sua API Key
Após criar sua conta, vá em Integrações e gere sua API Key:
- Acesse o Dashboard
- Vá em Integrações no menu lateral
- Clique em Criar Nova API Key
- Copie e guarde sua chave (ela não será exibida novamente!)
Importante: Guarde sua API Key em local seguro. Ela não será exibida novamente após criada.
Passo 3: Criar sua primeira cobrança
Agora você pode criar sua primeira cobrança PIX:
curl -X POST https://api.appzucropay.com/api/v1/charges \
-H "Content-Type: application/json" \
-H "X-API-Key: zp_sua_api_key_aqui" \
-d '{
"billing_type": "PIX",
"value": 99.90,
"description": "Produto de Teste",
"customer": {
"name": "João Silva",
"email": "joao@email.com",
"cpf_cnpj": "12345678900"
}
}'
Resposta
{
"id": "abc123-def456-ghi789",
"object": "charge",
"billing_type": "PIX",
"status": "PENDING",
"value": 99.90,
"net_value": 93.91,
"platform_fee": 5.99,
"pix": {
"txid": "zp1234567890abcdef...",
"qr_code": "data:image/png;base64,iVBORw0KGgo...",
"copy_paste": "00020126580014br.gov.bcb.pix...",
"expires_at": "2026-01-20T14:00:00Z"
},
"created_at": "2026-01-20T13:00:00Z"
}
Passo 4: Exibir o QR Code
Use o campo pix.qr_code para exibir a imagem do QR Code:
<img src="data:image/png;base64,iVBORw0KGgo..." alt="QR Code PIX" />
pix.copy_paste para o código copia-e-cola:
document.getElementById('pixCode').textContent = data.pix.copy_paste;
Passo 5: Verificar o pagamento
Você pode verificar o status de duas formas:
Opção 1: Polling (consultar periodicamente)
const checkPayment = setInterval(async () => {
const response = await fetch(`https://api.appzucropay.com/api/v1/charges/${chargeId}`, {
headers: { 'X-API-Key': 'zp_sua_api_key_aqui' }
});
const data = await response.json();
if (data.status === 'RECEIVED') {
clearInterval(checkPayment);
alert('Pagamento confirmado!');
}
}, 5000); // A cada 5 segundos
Opção 2: Webhooks (recomendado)
Configure um webhook para receber notificações em tempo real. Veja mais em Webhooks.
Próximos Passos
