P
API Parcred BrasilDocumentação
Status da API

Guia Completo de Teste

Siga este guia passo a passo para testar toda a integração no ambiente de homologação.

Pré-requisitos

Ferramentas Necessárias
  • curl - Para fazer requisições HTTP
  • jq - Para processar respostas JSON (opcional)
  • Acesso ao webhook.site - Para testar webhooks
1

Obter Token de Acesso

Primeiro, vamos autenticar e obter um token JWT válido:

Passo 1: Autenticaçãobash
TOKEN=$(curl -s -X POST https://api-angar-homologacao.onrender.com/v1/login \
  -H "Content-Type: application/json" \
  -d '{"client_id":"parceiro_abc_123","client_secret":"dK$!s#@j9sA*d(s@D*j"}' \
  | jq -r '.access_token')

echo "Token: $TOKEN"
2

Criar uma Proposta

Antes de executar este passo, acesse webhook.site e copie a URL única gerada. Substitua sua-url-unica no código abaixo:

Passo 2: Criar Propostabash
WEBHOOK_URL="https://webhook.site/sua-url-unica"

RESPONSE=$(curl -s -X POST https://api-angar-homologacao.onrender.com/v1/propostas \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d "{
    \"id_proposta_parceiro\":\"TESTE-INTEGRACAO-001\",
    \"cliente\":{
      \"nome\":\"Cliente Teste\",
      \"cpf\":\"111.222.333-44\",
      \"whatsapp\":\"5511912345678\"
    },
    \"simulacao\":{
      \"valores\":{
        \"solicitado\":1000,
        \"iof\":30,
        \"principal\":1030,
        \"parcela\":100,
        \"liquido\":1000,
        \"bruto\":2400
      },
      \"taxas\":{
        \"cet_am\":10,
        \"cet_aa\":200
      },
      \"prazos\":{
        \"total_parcelas\":24,
        \"primeiro_vencimento\":\"2026-01-15\",
        \"ultimo_vencimento\":\"2027-12-15\"
      }
    },
    \"webhook_url\":\"$WEBHOOK_URL\"
  }")

PROPOSTA_ID=$(echo "$RESPONSE" | jq -r '.id_proposta_angar')
echo "Proposta criada com ID: $PROPOSTA_ID"
3

Simular Aceite do Cliente

Agora vamos simular o cliente aceitando a proposta. Você pode fazer isso via cURL ou acessando a URL diretamente no navegador:

Passo 3: Simular Aceitebash
curl "https://api-angar-homologacao.onrender.com/confirmar/$PROPOSTA_ID?acao=aceitar"

Ou acesse no navegador:

https://api-angar-homologacao.onrender.com/confirmar/[PROPOSTA_ID]?acao=aceitar
4

Verificar o Webhook

Volte para a página do webhook.site que você abriu no Passo 2. Você deve ver uma nova requisição POST com:

Dados Recebidos

Headers

  • x-angar-signature - Assinatura HMAC-SHA256
  • content-type: application/json

Payload

  • id_proposta_angar - ID da proposta Parcred Brasil
  • id_proposta_parceiro - Seu ID (TESTE-INTEGRACAO-001)
  • status - ACEITO
  • timestamp - Data/hora do evento

Testando Recusa

Para testar o fluxo de recusa, repita os passos 2 e 3, mas no Passo 3 use:

https://api-angar-homologacao.onrender.com/confirmar/[PROPOSTA_ID]?acao=recusar

O webhook receberá status: "RECUSADO" ao invés de "ACEITO".

Solução de Problemas

Problemas Comuns

Erro 401 (Unauthorized)

Seu token expirou ou é inválido. Gere um novo token executando o Passo 1 novamente.

Erro 400 (Bad Request)

Verifique se o JSON está corretamente formatado e se todos os campos obrigatórios estão presentes.

Webhook não recebido

Verifique se a URL do webhook.site está correta e se a página está aberta no navegador. O webhook.site só mostra requisições em tempo real.

Proposta não encontrada

As propostas são armazenadas em memória no ambiente de homologação. Se o servidor for reiniciado, você precisará criar uma nova proposta.

Próximos Passos

Implementar em Produção

Após validar a integração em homologação, você está pronto para implementar em produção:

  • Solicite suas credenciais de produção à equipe Parcred Brasil
  • Implemente a validação de assinatura HMAC no seu webhook
  • Altere a URL base para o ambiente de produção
  • Configure monitoramento e logs
  • Teste com transações reais em volume controlado

Suporte

Precisa de Ajuda?

Em caso de dúvidas ou problemas durante a integração, entre em contato com nossa equipe de suporte técnico:

[email protected]