Para agendar uma cobrança no Pix Automático, a empresa recebedora deve enviar a solicitação de acordo com a periodicidade definida no contrato de recorrência. A solicitação de agendamento deve ser enviada entre 10 e 2 dias antes da data de vencimento, conforme regra estabelecida pelo Banco Central.
O cancelamento do agendamento pode ser realizado tanto pelo pagador quanto pelo recebedor, seguindo prazos específicos para cada parte:
- Recebedor: Pode cancelar até as 22h00 do dia anterior à data prevista para liquidação.
- Pagador: Pode cancelar até as 23h59 do dia anterior à data de liquidação.
A consulta de agendamentos e o cancelamento devem ser realizados por meio dos endpoints específicos desse serviço, permitindo que a empresa recebedora acesse o status dos agendamentos, seja de forma individual ou em lista.
Na chamada do endpoint
CobR, o usuário recebedor deve informar agência e conta de pagamento da Cielo. Como não existe um campo específico para o ISPB, não é possível indicar uma conta de outro PSP. Ou seja, a conta utilizada será sempre a da Cielo. É fundamental lembrar que essa conta não corresponde ao domicílio final de pagamento dos valores do Pix. O domicílio bancário real será aquele definido pela modalidade de recebimento escolhida pelo cliente.
Abaixo, apresentamos um exemplo com os campos obrigatórios para criação de cobrança recorrente.
| Método | Ambiente | Endpoint |
|---|---|---|
| PUT | Sandbox | https://api2.cielo.com.br/sandbox/cielo-pix/v1/cobr/\{txid} |
| PUT | Produção | https://api2.cielo.com.br/sandbox/cielo-pix/v1/cobr/\{txid} |
Requisição:
{
"idRec": "RR1234567820240115abcdefghijk",
"infoAdicional": "Serviços de Streaming de Música e Filmes.",
"calendario": {
"dataDeVencimento": "2024-04-15"
},
"valor": {
"original": "106.07"
},
"ajusteDiaUtil": true,
"devedor": {
"cep": "89256-140",
"cidade": "Uberlândia",
"email": "[email protected]",
"logradouro": "Alameda Franco 1056",
"uf": "MG"
},
"recebedor": {
"agencia": "9708",
"conta": "012682",
"tipoConta": "CORRENTE"
}
} Como o cliente acessa os dados da sua conta?
Na chamada do endpoint CobR, o usuário recebedor deve informar agência e conta de pagamento da Cielo. Para encontrar essses dados, no Site Cielo, em ambiente logado, acesse a aba Pix e serão apresentados os dados da Conta de pagamento, conforme abaixo:
