Cora (403): autorização pelo app, sem certificado
O Cora é o único banco em que você não preenche Client ID nem Secret: a conexão é autorizada por você mesmo, entrando na sua conta Cora por uma janela do próprio banco. Este artigo mostra esse fluxo, o boleto híbrido com Pix, e as três coisas que a API do Cora não faz.
Quando usar
Use ao conectar a conta Cora pela primeira vez, quando a autorização expirar, ou quando precisar alterar um boleto e o sistema recusar.
Antes de começar
- Conta Cora ativa, com acesso ao aplicativo do banco para autorizar e para aprovar pagamentos.
- Conta Cora cadastrada no Hap.
O que muda no Cora
Nos outros bancos você recebe credenciais e as digita no convênio. No Cora não: a Hap é cadastrada como parceira do banco, e você autoriza essa parceria entrando na sua própria conta Cora, por uma janela do banco. Não há Client ID, Client Secret nem certificado para preencher.
| Recurso | Como funciona |
|---|---|
| Boleto | Emitir, consultar e cancelar pela API. |
| Boleto híbrido | Marque Boleto híbrido e o boleto sai com QR Code Pix embutido. |
| Pix | Cobrança imediata e com vencimento. |
| Extrato | Sim, sem limite de janela e sem exigir certificado. |
| Pagamentos | Sim, mas exigem aprovação no aplicativo do Cora. |
| Alterar boleto | Não. Para mudar valor ou vencimento, cancele e emita outro. |
| Devolver Pix | Não pela API. Faça pelo internet banking. |
| Sustar protesto ou negativação | Não pela API. O Hap recusa e orienta a fazer manualmente. |
Autorizar a conta
- 1
Na aba Convênios da conta Cora, marque Registro WebService? e escolha o Ambiente.
- 2
SALVE o convênio. O botão de autorização só aparece depois de salvar.
- 3
Clique em Conectar minha conta Cora. Abre uma janela com a tela de login do próprio Cora.
- 4
Entre com o seu acesso do app Cora e autorize a aplicação a operar na sua conta.
- 5
O card passa a mostrar que a conta está autorizada, com a data. A partir daí o convênio emite boletos.
Problemas comuns
- O botão Conectar minha conta Cora está desabilitado: ele só habilita depois que o convênio é salvo. Salve primeiro, depois autorize.
- A conexão parou de funcionar sozinha: a autorização do Cora expira após 60 dias sem uso, e também cai se alguém revogar a aplicação pelo app do banco. Refaça a autorização pelo mesmo botão.
- Não consigo alterar o valor ou o vencimento de um boleto: a API do Cora não permite alteração. Cancele o boleto e emita outro.
- O cancelamento de um boleto protestado ou negativado é recusado: a API do Cora também não faz isso. Nesses casos a ação é manual, pelo internet banking.
- O pagamento ficou como iniciado e não saiu: o Cora exige aprovação no aplicativo do banco. O Hap inicia e aguarda - alguém precisa aprovar no app.
