Contas Pix Automático
A conta Pix Automático liga uma conta financeira sua e uma conexão com o banco ao Pix Automático. Recorrências, solicitações, cobranças e localizações sempre pertencem a uma conta Pix Automático, e é por ela que a Kobana sabe em qual banco e com quais credenciais registrar cada operação.
A conta é gerenciada pela API v2.
Dados da conta
| Campo | Obrigatório | Descrição |
|---|---|---|
| Conta Financeira | Sim | Conta financeira que recebe os pagamentos. O banco da conta Pix Automático é o banco dessa conta financeira. |
| Nome da Conta | Não | Nome para identificar a conta. Se ficar em branco, a Kobana usa o nome do banco. |
| ID Externo | Não | Identificador do seu sistema. Não pode se repetir entre contas Pix Automático da mesma conta Kobana. |
| Etiquetas e Dados Personalizados | Não | Informações livres para organizar e buscar. |
A conta financeira não pode ser trocada depois que a conta Pix Automático é criada.
Conexão com o banco
A conexão é associada à conta Pix Automático pela API de conexões. Ela precisa:
- ter o escopo de Pix Automático;
- ser do mesmo banco da conta financeira.
Ao associar a conexão, a Kobana valida a conta com o banco na hora. Se o banco recusar, a associação é desfeita e a conta continua sem conexão. Depois de associada, a conexão não pode ser removida da conta Pix Automático.
Situações
| Situação | O que significa |
|---|---|
| Pendente | A conta ainda não foi validada com o banco. |
| Inativa | A conta foi validada, mas está desabilitada. |
| Ativa | A conta está habilitada. |
Excluir
Uma conta Pix Automático que já tem recorrências, solicitações, cobranças ou localizações não pode ser excluída.
Eventos de webhook
| Código | Quando |
|---|---|
charge.automatic_pix.account.db.created | Conta criada |
charge.automatic_pix.account.db.updated | Conta alterada |
charge.automatic_pix.account.db.deleted | Conta excluída |
Pela API
Criação, consulta, alteração e exclusão de contas Pix Automático estão na API v2.