Pix Automático — visão geral
O Pix Automático é a cobrança recorrente do arranjo Pix. O pagador autoriza uma vez no app do banco dele, e a sua conta agenda cada cobrança sem nova confirmação. A conta CorpX é sempre a recebedora.
A feature automatic_pix nasce desligada para todos os tenants. Enquanto estiver off, toda rota em /v1/accounts/{accountId}/pix/automatic responde 403 feature_disabled. A CorpX liga a feature pelo painel administrativo depois do contrato. Desligar depois não cancela recorrência já autorizada.
Escopo da credencial: pix.automatic. As leituras também aceitam read. No painel, ver exige pix_automatic.view e emitir ou adiar exige pix_automatic.manage.
Como começa uma recorrência
Detalhes em Recorrências e QR composto.
Ciclo de vida
Cada mudança relevante gera um webhook pix.automatic.* e um evento pix_automatic.* na timeline, ancorado no recurrenceId.
Payloads em Webhooks.
Dois identificadores
recurrenceIdé o UUID que a API devolve na criação. É o id da recorrência nesta API, no webhook e na timeline.recurrenceIdentifier(RR…ouRN…) é o id do arranjo Pix. Aparece quando o arranjo atribui e é o que o pagador vê no banco dele.
Toda rota com {recurrenceId} aceita os dois. O RR…/RN… só é reconhecido depois que a recorrência passou por esta API ou por um webhook da conta.
Próximos passos
- Recorrências e QR composto: criar, listar e consultar.
- Agendamentos e retentativas: cobrar, adiar e tentar de novo.