> For the complete documentation index, see [llms.txt](https://docs.giro.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.giro.tech/introducao/produtos-da-giro.tech/formalizacao-de-credito/homologacao/chaves-pix-de-teste.md).

# Chaves PIX de teste

No ambiente de **homologação**, a plataforma disponibiliza chaves PIX e números de conta bancária de teste para simular diferentes resultados de liquidação da operação. Utilize esses dados na formalização da CCB (via chave PIX ou conta bancária) para validar o comportamento da sua integração e o recebimento dos webhooks correspondentes.

> ℹ️ Esses dados **só funcionam no ambiente de homologação**. Não utilize chaves ou contas de teste em produção.

## Como utilizar

1. Formalize uma operação CCB informando uma das chaves PIX de teste **ou** o número de conta bancária correspondente.
2. Aguarde o processamento da liquidação (em homologação, o retorno via webhook pode levar alguns minutos).
3. Verifique o webhook recebido no endpoint cadastrado para o tipo de evento esperado.

Para cadastrar os webhooks necessários, consulte o [guia de cadastro](https://docs.giro.tech/introducao/produtos-da-giro.tech/formalizacao-de-credito/webhooks/cadastro-de-webhook.md).

## Tabela de cenários

| Tipo                                                                   | Chave PIX (EVP)                        | Nº conta bancária | Evento esperado                                                                                                                                                                                                                                                                                                                                      | Mensagem no webhook (`dados.erro.mensagem`)                                                                                                                                                                    | Ações do cliente                                                                                                                                                                                                                                                                                                                                                                                         |
| ---------------------------------------------------------------------- | -------------------------------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Chave Pix inválida.                                                    | `b6a1e5cc-96c2-488f-b98a-7c9d968f9a11` | `2847193056`      | REVISAO\_DESEMBOLSO (programa habilitado) ou FALHA\_DESEMBOLSO — ver [revisão](https://docs.giro.tech/desenvolvedores/api-formalizacao-de-credito/api-reference/webhooks/webhook-de-revisao-de-liquidacao.md) e [falha](https://docs.giro.tech/desenvolvedores/api-formalizacao-de-credito/api-reference/webhooks/webhook-de-falha-na-liquidacao.md) | Chave Pix inexistente ou inválida. Verifique o tipo e o formato da chave conforme padrão do Bacen. Envie novos dados bancários                                                                                 | Com revisão habilitada: receber o webhook e enviar **nova** conta via [revisão de liquidação](https://docs.giro.tech/introducao/produtos-da-giro.tech/formalizacao-de-credito/revisao-de-liquidacao.md#como-realizar-a-revisao-de-liquidacao). Sem revisão: aguardar nossa equipe avaliar e, se necessário, entrar em contato para novos dados bancários                                                 |
| Erro desconhecido                                                      | `708192a3-b4c5-4345-a6b7-c8d9e0f1a2b3` | `3958204167`      | FALHA\_DESEMBOLSO — ver [falha](https://docs.giro.tech/desenvolvedores/api-formalizacao-de-credito/api-reference/webhooks/webhook-de-falha-na-liquidacao.md)                                                                                                                                                                                         | Falha no desembolso, entre em contato com a equipe                                                                                                                                                             | Aguardar nossa equipe avaliar e entrar em contato para resolução                                                                                                                                                                                                                                                                                                                                         |
| Instabilidade bancaria                                                 | `c8d3e1f2-7a4b-4c9d-8e6f-1a2b3c4d5e6f` | `5170426389`      | REVISAO\_DESEMBOLSO (programa habilitado) ou FALHA\_DESEMBOLSO — ver [revisão](https://docs.giro.tech/desenvolvedores/api-formalizacao-de-credito/api-reference/webhooks/webhook-de-revisao-de-liquidacao.md) e [falha](https://docs.giro.tech/desenvolvedores/api-formalizacao-de-credito/api-reference/webhooks/webhook-de-falha-na-liquidacao.md) | Houve uma instabilidade na comunicação com o banco                                                                                                                                                             | Com revisão habilitada: receber o webhook e escolher **retentativa** com a mesma conta ou envio de **nova** conta via [revisão de liquidação](https://docs.giro.tech/introducao/produtos-da-giro.tech/formalizacao-de-credito/revisao-de-liquidacao.md#como-realizar-a-revisao-de-liquidacao). Sem revisão: aguardar nossa equipe avaliar e, se necessário, entrar em contato para novos dados bancários |
| Instabilidade bancaria                                                 | `e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b` | `6281537490`      | REVISAO\_DESEMBOLSO (programa habilitado) ou FALHA\_DESEMBOLSO — ver [revisão](https://docs.giro.tech/desenvolvedores/api-formalizacao-de-credito/api-reference/webhooks/webhook-de-revisao-de-liquidacao.md) e [falha](https://docs.giro.tech/desenvolvedores/api-formalizacao-de-credito/api-reference/webhooks/webhook-de-falha-na-liquidacao.md) | Houve uma instabilidade na comunicação com o banco                                                                                                                                                             | Com revisão habilitada: receber o webhook e escolher **retentativa** com a mesma conta ou envio de **nova** conta via [revisão de liquidação](https://docs.giro.tech/introducao/produtos-da-giro.tech/formalizacao-de-credito/revisao-de-liquidacao.md#como-realizar-a-revisao-de-liquidacao). Sem revisão: aguardar nossa equipe avaliar e, se necessário, entrar em contato para novos dados bancários |
| Instabilidade bancaria                                                 | `d4e5f6a7-b8c9-4d0e-9f1a-2b3c4d5e6f70` | `7392648501`      | REVISAO\_DESEMBOLSO (programa habilitado) ou FALHA\_DESEMBOLSO — ver [revisão](https://docs.giro.tech/desenvolvedores/api-formalizacao-de-credito/api-reference/webhooks/webhook-de-revisao-de-liquidacao.md) e [falha](https://docs.giro.tech/desenvolvedores/api-formalizacao-de-credito/api-reference/webhooks/webhook-de-falha-na-liquidacao.md) | Houve uma instabilidade na comunicação com o banco                                                                                                                                                             | Com revisão habilitada: receber o webhook e escolher **retentativa** com a mesma conta ou envio de **nova** conta via [revisão de liquidação](https://docs.giro.tech/introducao/produtos-da-giro.tech/formalizacao-de-credito/revisao-de-liquidacao.md#como-realizar-a-revisao-de-liquidacao). Sem revisão: aguardar nossa equipe avaliar e, se necessário, entrar em contato para novos dados bancários |
| Instabilidade bancaria                                                 | `b2c4d6e8-f0a1-4b3c-9d5e-7f8a9b0c1d2e` | `8403759612`      | REVISAO\_DESEMBOLSO (programa habilitado) ou FALHA\_DESEMBOLSO — ver [revisão](https://docs.giro.tech/desenvolvedores/api-formalizacao-de-credito/api-reference/webhooks/webhook-de-revisao-de-liquidacao.md) e [falha](https://docs.giro.tech/desenvolvedores/api-formalizacao-de-credito/api-reference/webhooks/webhook-de-falha-na-liquidacao.md) | Houve uma instabilidade na comunicação com o banco                                                                                                                                                             | Com revisão habilitada: receber o webhook e escolher **retentativa** com a mesma conta ou envio de **nova** conta via [revisão de liquidação](https://docs.giro.tech/introducao/produtos-da-giro.tech/formalizacao-de-credito/revisao-de-liquidacao.md#como-realizar-a-revisao-de-liquidacao). Sem revisão: aguardar nossa equipe avaliar e, se necessário, entrar em contato para novos dados bancários |
| Instabilidade bancaria                                                 | `a7b8c9d0-e1f2-4a3b-8c4d-5e6f7a8b9c0d` | `9514860723`      | REVISAO\_DESEMBOLSO (programa habilitado) ou FALHA\_DESEMBOLSO — ver [revisão](https://docs.giro.tech/desenvolvedores/api-formalizacao-de-credito/api-reference/webhooks/webhook-de-revisao-de-liquidacao.md) e [falha](https://docs.giro.tech/desenvolvedores/api-formalizacao-de-credito/api-reference/webhooks/webhook-de-falha-na-liquidacao.md) | Houve uma instabilidade na comunicação com o banco                                                                                                                                                             | Com revisão habilitada: receber o webhook e escolher **retentativa** com a mesma conta ou envio de **nova** conta via [revisão de liquidação](https://docs.giro.tech/introducao/produtos-da-giro.tech/formalizacao-de-credito/revisao-de-liquidacao.md#como-realizar-a-revisao-de-liquidacao). Sem revisão: aguardar nossa equipe avaliar e, se necessário, entrar em contato para novos dados bancários |
| Recusa da instituição recebedora por conta bloqueada                   | `1a2b3c4d-5e6f-4789-a0b1-c2d3e4f5a6b7` | `1625970834`      | REVISAO\_DESEMBOLSO (programa habilitado) ou FALHA\_DESEMBOLSO — ver [revisão](https://docs.giro.tech/desenvolvedores/api-formalizacao-de-credito/api-reference/webhooks/webhook-de-revisao-de-liquidacao.md) e [falha](https://docs.giro.tech/desenvolvedores/api-formalizacao-de-credito/api-reference/webhooks/webhook-de-falha-na-liquidacao.md) | A instituição do recebedor recusou a transação devido a uma inconsistência ou restrição na conta de destino, como dados inválidos, tipo de conta não suportado ou conta bloqueada. Envie novos dados bancários | Com revisão habilitada: receber o webhook e enviar **nova** conta via [revisão de liquidação](https://docs.giro.tech/introducao/produtos-da-giro.tech/formalizacao-de-credito/revisao-de-liquidacao.md#como-realizar-a-revisao-de-liquidacao). Sem revisão: aguardar nossa equipe avaliar e, se necessário, entrar em contato para novos dados bancários                                                 |
| CPF/CNPJ do usuário recebedor não é consistente com o titular da conta | `2b3c4d5e-6f70-4890-b1c2-d3e4f5a6b7c8` | `2736081945`      | REVISAO\_DESEMBOLSO (programa habilitado) ou FALHA\_DESEMBOLSO — ver [revisão](https://docs.giro.tech/desenvolvedores/api-formalizacao-de-credito/api-reference/webhooks/webhook-de-revisao-de-liquidacao.md) e [falha](https://docs.giro.tech/desenvolvedores/api-formalizacao-de-credito/api-reference/webhooks/webhook-de-falha-na-liquidacao.md) | CPF/CNPJ do usuário recebedor não é consistente com o titular da conta transacional especificada. Envie novos dados bancários                                                                                  | Com revisão habilitada: receber o webhook e enviar **nova** conta via [revisão de liquidação](https://docs.giro.tech/introducao/produtos-da-giro.tech/formalizacao-de-credito/revisao-de-liquidacao.md#como-realizar-a-revisao-de-liquidacao). Sem revisão: aguardar nossa equipe avaliar e, se necessário, entrar em contato para novos dados bancários                                                 |
| Recusa da instituição recebedora por conta invalida                    | `3c4d5e6f-7081-4901-c2d3-e4f5a6b7c8d9` | `3847192056`      | REVISAO\_DESEMBOLSO (programa habilitado) ou FALHA\_DESEMBOLSO — ver [revisão](https://docs.giro.tech/desenvolvedores/api-formalizacao-de-credito/api-reference/webhooks/webhook-de-revisao-de-liquidacao.md) e [falha](https://docs.giro.tech/desenvolvedores/api-formalizacao-de-credito/api-reference/webhooks/webhook-de-falha-na-liquidacao.md) | Número da agência ou conta transacional inexistente ou inválido. Envie novos dados bancários                                                                                                                   | Com revisão habilitada: receber o webhook e enviar **nova** conta via [revisão de liquidação](https://docs.giro.tech/introducao/produtos-da-giro.tech/formalizacao-de-credito/revisao-de-liquidacao.md#como-realizar-a-revisao-de-liquidacao). Sem revisão: aguardar nossa equipe avaliar e, se necessário, entrar em contato para novos dados bancários                                                 |
| Chave pix não existe                                                   | `4d5e6f70-8192-4012-d3e4-f5a6b7c8d9e0` | `4958203167`      | REVISAO\_DESEMBOLSO (programa habilitado) ou FALHA\_DESEMBOLSO — ver [revisão](https://docs.giro.tech/desenvolvedores/api-formalizacao-de-credito/api-reference/webhooks/webhook-de-revisao-de-liquidacao.md) e [falha](https://docs.giro.tech/desenvolvedores/api-formalizacao-de-credito/api-reference/webhooks/webhook-de-falha-na-liquidacao.md) | Chave Pix inexistente ou inválida. Verifique o tipo e o formato da chave conforme padrão do Bacen. Envie novos dados bancários                                                                                 | Com revisão habilitada: receber o webhook e enviar **nova** conta via [revisão de liquidação](https://docs.giro.tech/introducao/produtos-da-giro.tech/formalizacao-de-credito/revisao-de-liquidacao.md#como-realizar-a-revisao-de-liquidacao). Sem revisão: aguardar nossa equipe avaliar e, se necessário, entrar em contato para novos dados bancários                                                 |
| Banco inválido                                                         | `5e6f7081-92a3-4123-e4f5-a6b7c8d9e0f1` | `5069314278`      | REVISAO\_DESEMBOLSO (programa habilitado) ou FALHA\_DESEMBOLSO — ver [revisão](https://docs.giro.tech/desenvolvedores/api-formalizacao-de-credito/api-reference/webhooks/webhook-de-revisao-de-liquidacao.md) e [falha](https://docs.giro.tech/desenvolvedores/api-formalizacao-de-credito/api-reference/webhooks/webhook-de-falha-na-liquidacao.md) | Banco inválido ou não encontrado. Envie novos dados bancários                                                                                                                                                  | Com revisão habilitada: receber o webhook e enviar **nova** conta via [revisão de liquidação](https://docs.giro.tech/introducao/produtos-da-giro.tech/formalizacao-de-credito/revisao-de-liquidacao.md#como-realizar-a-revisao-de-liquidacao). Sem revisão: aguardar nossa equipe avaliar e, se necessário, entrar em contato para novos dados bancários                                                 |
| Saldo insuficiente                                                     | `6f708192-a3b4-4234-f5a6-b7c8d9e0f1a2` | `6170425389`      | FALHA\_DESEMBOLSO — ver [falha](https://docs.giro.tech/desenvolvedores/api-formalizacao-de-credito/api-reference/webhooks/webhook-de-falha-na-liquidacao.md)                                                                                                                                                                                         | O pagamento foi rejeitado porque o saldo disponível não cobre o valor da transação                                                                                                                             | Aguardar nossa equipe avaliar e entrar em contato para resolução                                                                                                                                                                                                                                                                                                                                         |
| Liquidação concluída                                                   | `9a0b1c2d-3e4f-5a6b-9c0d-1e2f3a4b5c6d` | `7281536490`      | SUCESSO\_DESEMBOLSO — ver [pagamento](https://docs.giro.tech/desenvolvedores/api-formalizacao-de-credito/api-reference/webhooks/webhooks-de-liquidacao-da-operacao.md)                                                                                                                                                                               | —                                                                                                                                                                                                              | Confirmar o recebimento do webhook; atualizar o status da operação como liquidada                                                                                                                                                                                                                                                                                                                        |

⚠️ **Aviso:** Os cenários `REVISAO_DESEMBOLSO` exigem configuração prévia do programa e cadastro do webhook correspondente. Consulte o [guia de revisão de liquidação](https://docs.giro.tech/introducao/produtos-da-giro.tech/formalizacao-de-credito/revisao-de-liquidacao.md) para os pré-requisitos e o fluxo completo de revisão de liquidação.

Apenas cenários do tipo **Instabilidade bancaria** permitem **retentativa** com a mesma conta. Nos demais casos de revisão, é necessário informar uma **nova** conta.

## Mensagens de erro no webhook

Quando a liquidação falha, o campo `dados.erro.mensagem` do webhook pode trazer uma das mensagens abaixo. Use esta referência para validar o processamento da sua integração:

⚠️ **Aviso:** As mensagens abaixo podem evoluir ao longo do tempo. Recomendamos tratar `dados.erro.mensagem` sempre como uma **string**, sem depender de correspondência exata com estes textos na lógica de negócio da sua integração.

| Mensagem (`dados.erro.mensagem`)                                                                                                                                                                               |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Número da agência ou conta transacional inexistente ou inválido. Envie novos dados bancários                                                                                                                   |
| A instituição do recebedor recusou a transação devido a uma inconsistência ou restrição na conta de destino, como dados inválidos, tipo de conta não suportado ou conta bloqueada. Envie novos dados bancários |
| CPF/CNPJ do usuário recebedor não é consistente com o titular da conta transacional especificada. Envie novos dados bancários                                                                                  |
| Falha no desembolso, entre em contato com a equipe                                                                                                                                                             |
| Houve uma instabilidade na comunicação com o banco                                                                                                                                                             |
| Banco inválido ou não encontrado. Envie novos dados bancários                                                                                                                                                  |
| Chave Pix inexistente ou inválida. Verifique o tipo e o formato da chave conforme padrão do Bacen. Envie novos dados bancários                                                                                 |
| O pagamento foi rejeitado porque o saldo disponível não cobre o valor da transação                                                                                                                             |

## Formalização com conta bancária

Os mesmos cenários podem ser simulados informando o **número da conta** da tabela no lugar da chave PIX, quando a formalização utilizar dados de conta bancária em vez de PIX. Os demais campos da conta (banco, agência, dígito, titular) podem seguir o padrão da sua integração de homologação.

<figure><img src="https://978140111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF6l1W0qI0y7eF7f0QRDC%2Fuploads%2Fgit-blob-f5d2064d02c970341ca52b2c083eb1f585bc436a%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

{% embed url="<https://giro.tech/central-de-atendimento/>" %}
