Retentativas de Recebimento

Caso o recebimento não tenha ocorrido com sucesso na data de vencimento, é possível efetuar 3 retentativas nos 7 dias corridos seguintes a data de vencimento.

Nestes casos, a empresa recebedora enviará sempre o mesmo valor do vencimento, mas poderá escolher em quais 3 dias tentará efetuar as cobranças do cliente.

Por exemplo, é possível realizar tentativas em D+1, D+2 e D+7 ou então D+1, D+4 e D+7.
Essa é uma liberdade que o recebedor possui.

Importante reforçar que mesmo que o pagamento não ocorra, a adesão ao Pix Automático do cliente pagador continuará ativa para os próximos ciclos de cobrança recorrente.

Para os casos onde será necessário realizar retentativas de recebimento, o fluxo será o seguinte:

1. Primeiramente, como não será realizado a liquidação, não será enviado nenhum webhook de recebimento. Ao invés disso, será enviado um webhook informando que a instrução de agendamento está expirada.
2. Após receber esse webhook, fica 100% a critério do recebedor realizar as novas tentativas. A Celcoin não realizará automaticamente nenhuma retentativa. A empresa recebedora deverá definir conforme os seus próprios critérios em quais datas (entre D+1 e D+7) gostará de realizar as novas tentativas. Reforçando que não é obrigatório realizar 3 retentativas, fica a critério da empresa recebedora se não irá realizar retentativas, se realizará somente 1 retentativa, 2 ou todas 3, se necessário.
3. Celcoin receberá a solicitação da empresa recebedora e enviará ao banco pagador a solicitação de retentativa.
4. Celcoin enviará a empresa recebedora o webhook com o resultado da retentativa.

Webhook de instrução de pagamento expirada
evento: pix-automatic-payment-instruction-expired

{
  "amount": 100,
  "debitParty": {
    "bank": "10203040",
    "taxId": "00011122233",
    "accountType": "CACC",
    "stateCode": "3505708",
    "personType": "NATURAL_PERSON",
    "branch": "10203040",
    "account": "98765-4"
  },
  "updateDate": "2025-07-10T20:42:37",
  "clientRequestId": "123423432",
  "endToEndId": "E139358932025060729929144441",
  "isWorkingDay": false,
  "debtor": {
    "taxId": "00011122233",
    "name": "Pessoa Fictícia",
    "personType": "NATURAL_PERSON"
  },
  "recurrencyId": "RR139358932025060758317314721",
  "id": "asdfgfsdew",
  "creditParty": {
    "bank": "13935893",
    "taxId": "76008951000179",
    "name": "Empresa Fictícia",
    "branch": "10203040",
    "account": "98765-4"
  },
  "expirationDate": "2025-06-07",
  "status": "EXPIRED",
  "createDate": "2025-06-07"
}

Recebedor comanda nova tentativa
Endpoint POST /recurrencies/{id}/payment-instruction/{id}/new-attempt

Atenção❗❗❗: é obrigatório que a retentativa seja no mesmo valor do pagamento original, por isso, não é possível informar nenhum outro dado a não ser a nova data de tentativa.

Request:

{
 "newExpirationDate: datetime,

Response

{
    "version": "1.0.0",
    "status": 200,
    "body": {
        "id": "asdfgfsdew",
        "endToEndId": "E139358932025060789659528960",
        "recurrencyId": "RR139358932025060758317314721",
        "amount": 100,
        "status": "PENDING_SENDING_DEBTOR",
        "expirationDate": "2025-06-07",
        "nextWorkingDay": null,
        "creditParty": {
            "bank": "13935893",
            "branch": "10203040",
            "account": "98765-4",
            "taxId": "76008951000179",
            "name": "Empresa Fictícia"
        },
        "debtor": {
            "personType": "NATURAL_PERSON",
            "taxId": "00011122233",
            "name": "Pessoa Fictícia"
        },
        "debitParty": {
            "bank": "10203040",
            "personType": "NATURAL_PERSON",
            "taxId": "00011122233",
            "accountType": "CACC",
            "branch": "10203040",
            "account": "98765-4",
            "stateCode": "3505708"
        },
        "createDate": "2025-06-07",
        "clientRequestId": 123423432
    }
}

Por fim, a Celcoin enviará o webhook de completed.

Webhook completed
evento: pix-automatic-payment-instruction-completed

{
  "id": "asdfgfsdew",
  "endToEndId": "E1393589320250607087449852020",
  "recurrencyId": "RR139358932025060758317314721",
  "amount": 100,
  "expirationDate": "2025-06-07",
  "isWorkingDay": false,
  "nextWorkingDay": null,
  "status": "ACCEPTED | REJECTED",
  "creditParty": {
    "bank": "13935893",
    "branch": "10203040",
    "account": "98765-4",
    "taxId": "76008951000179",
    "name": "Empresa Fictícia"
  },
  "debitParty": {
    "bank": "10203040",
    "personType": "NATURAL_PERSON",
    "taxId": "00011122233",
    "name": null,
    "branch": "10203040",
    "account": "98765-4",
    "accountType": "CACC",
    "stateCode": "3505708"
  },
  "debtor": {
    "personType": "NATURAL_PERSON",
    "taxId": "00011122233",
    "name": "Pessoa Fictícia"
  },
  "createDate": "2025-06-07",
  "updateDate": "2025-07-14T19:48:33",
  "clientRequestId": "123423432",
  "cancellation": null,
  "webhookId": "4f829eca69704d4c90686a6d067b1c84"
}

❗️

Esta documentação ainda está sujeita a atualizações. Quando tivermos a versão final publicada, este aviso será removido de todas as páginas.