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

{
    "body": {
        "id":"36f14f45-b909-4195-814b639d5f9df693",
        "endToEndId": "E13935893202510150000O1efRkdbbel",
        "recurrencyId": "RR1393589320250820fqpb80CzMdC",
        "amount": 200,
        "expirationDate": "10\/13\/2025 00: 00: 00",
        "isWorkingDay": true,
        "nextWorkingDay": null,
        "status": "EXPIRED",
        "creditParty": {
            "bank": "13935893",
            "branch": "0001",
            "account": "000123456789",
            "taxId": "12345678901",
            "name": "Jo\u00e3o da Silva"
        },
        "debitParty": {
            "bank": "13935893",
            "personType": "NATURAL_PERSON",
            "taxId": "22698938080",
            "name": "Jo\u00e3o da Silva",
            "branch": "0001",
            "account": "5234565",
            "accountType": null,
            "stateCode": null
        },
        "debtor": {
            "personType": "NATURAL_PERSON",
            "taxId": "22698938080",
            "name": "Jo\u00e3o da Silva"
        },
        "createDate": "2025-09-15T00: 00: 00.0000000",
        "updateDate": "2025-09-15T12: 34: 32.3741844",
        "clientRequestId": "9ed85182c3b85aa467028128945420c405138398",
        "cancellation": null
    },
    "entity":"pix-automatic-payment-instructionexpired",
    "createTimeStamp": "2025-09-15T12: 34: 52.7451567",
    "status": "EXPIRED",
    "webhookId": "72f2d5d443834f06af1769583effbb6c"
}

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

{
    "body": {
        "id": "E13935893202507281501BFdLbInlHec",
        "endToEndId": "E1393589320250607169026668510",
        "recurrencyId": "RR1393589320250820fqpb80CzMdC",
        "amount": 200,
        "expirationDate": "2025-06-07",
        "isWorkingDay": false,
        "nextWorkingDay": null,
        "status": "ACCEPTED",
        "creditParty": {
            "bank": "13935893",
            "branch": "10203040",
            "account": "98765-4",
            "taxId": "76008951000179",
            "name": "Empresa Fict\u00edcia"
        },
        "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\u00edcia"
        },
        "createDate": "2025-06-07",
        "updateDate": "2025-09-12T11: 45: 56",
        "clientRequestId": "99c2c57fbde28d2b2d974685af8ca490a2ea4988",
        "cancellation": null
    },
    "entity": "pix-automatic-payment-instruction-completed",
    "createTimeStamp": "2025-09-12T11: 45: 56.8838635",
    "status": "ACCEPTED",
    "webhookId": "30dc87f5476345de85e8c138fe611bef"
}