Retentar cobrança não paga com Pix Automático

ℹ️
Saiba mais sobre essa funcionalidade na documentação.

Quando o pagamento de uma cobrança recorrente não é confirmado, é possível enviar até três retentativas de cobrança dentro do período de sete dias.

Requisição

{
    "MerchantOrderId": "1234567890",
    "OrderDescription": "Serviço de streaming",
    "Customer": {
        "Name": "Aline de Souza",
        "Identity": "123...",
        "IdentityType": "CPF"
    },
    "Payment": {
        "Type": "Pix",
        "Amount": 100,
        "Provider": "Cielo2",
        "RecurrentPayment": {
            "AuthorizeNow": true,
            "RecurrentType": "SelfManagedConsent",
            "RecurrencePaymentId": "1475900f-8189-4581-be5d-1956c00b04b0",
            "LiquidationDate": "2025-07-02",
        }
    }
}

Parâmetros no header

Propriedade	Descrição	Tipo	Tamanho	Obrigatório
`MerchantId`	Identificador da loja na API E-commerce Cielo.	GUID	36	Sim
`MerchantKey`	Chave pública para autenticação dupla na API E-commerce Cielo.	string	40	Sim
`RequestId`	Identificador da requisição, usado quando a loja usa diferentes servidores para cada GET/POST/PUT.	GUID	36	Não

Parâmetros no body

Parâmetro	Descrição	Tipo	Tamanho	Obrigatório?
`MerchantOrderId`	Número de identificação do pedido. O `MerchantOrderId` será encaminhado para o provedor de Pix como o número do contrato de recorrência, ou código que representa a autorização. Atenção: Os caracteres permitidos são apenas a-z, A-Z, 0-9. Não são permitidos caracteres especiais e espaços em branco..	string	50	Sim
`OrderDescription`	É a descrição do objeto a ser contratado de forma recorrente. Ex.: serviço de streaming, matrícula de academia, conta recorrente de energia elétrica etc.	string	-	Não
`Customer.Name`	Nome do comprador. Atenção: os caracteres permitidos são apenas a-z, A-Z. Não são permitidos caracteres especiais e números.	string	255	Não
`Customer.Identity`	Número do CPF ou CNPJ do comprador.	string	18	Não
`Customer.IdentityType`	Tipo de documento de identificação do comprador (CPF ou CNPJ).	string	255	Não
`Payment.Type`	Tipo do meio de pagamento. Neste caso, use "Pix".	string	-	Sim
`Payment.Provider`	Nome do provedor do meio de pagamento. Neste caso, use "Cielo2".	string	-	Sim
`Payment.RecurrentPayment.AuthorizeNow`	Indica se a cobrança será feita imediatamente. Neste caso, use "true".	boolean	-	Sim
`Payment.RecurrentPayment.RecurrenceType`	Identificador do tipo de recorrência. Neste caso, use "SelfManagedConsent"	string	-	Não
`Payment.RecurrentPayment.RecurrencePaymentId`	Identificador da cobrança original na qual houve falha. A API retorna como `PaymentId`.	string	36	Sim
`Payment.RecurrentPayment.LiquidationDate`	Data prevista para liquidação da ordem de pagamento correspondente. Formato: 2030-12-31 (YYYY-MM-DD)	date	10	Sim

Resposta

{
    "MerchantOrderId": "0b82a695774a4febace301f07",
    "Customer": {
        "Name": "Aline de Souza"
    },
    "Payment": {
        "RecurrentPayment": {
            "RecurrenceType": "SelfManagedConsent",
            "RecurrencePaymentId": "ab0a00e0-f0c1-4358-aa9f-c42be5e28057",
            "LiquidationDate": "2025-07-02T00:00:00",
            "Interval": 1,
            "AuthorizeNow": true
        },
        "Tid": "ab0a00e0f0c14358aa9fc42be5e28057",
        "SentOrderId": "ab0a00e0f0c14358aa9fc42be5e28057",
        "ReceivedDate": "2025-08-01 14:21:01",
        "Provider": "Cielo2",
        "Status": 12,
        "IsSplitted": false,
        "ReturnMessage": "OPERACAO REALIZADA COM SUCESSO",
        "ReturnCode": "0",
        "PaymentId": "ab0a00e0-f0c1-4358-aa9f-c42be5e28057",
        "Type": "Pix",
        "Currency": "BRL",
        "Country": "BRA",
        "Links": [
            {
                "Method": "GET",
                "Rel": "self",
                "Href": "https://apiquerysandbox.cieloecommerce.cielo.com.br/1/sales/ab0a00e0-f0c1-4358-aa9f-c42be5e28057"
            }
        ]
    }
}

A resposta irá retornar o identificador dessa cobrança específica no campo Payment.PaymentId:

Parâmetro	Descrição
`Payment.SentOrderId`	Identificador da transação Pix, representa o `txid` da cobrança recorrente
`Payment.PaymentId`	Identificador da transação na API E-commerce Cielo.

⚠️
Atenção:
A resposta da retentativa de cobrança gera seu próprio Payment.SentOrderId(correspondente ao txid) e PaymentId, porém, no caso de uma retentativa posterior é importante informar o RecurrencePaymentId da cobrança original (aquela na qual houve a primeira negativa).

O Pix Automático não tem ambiente sandbox disponível no momento.

ℹ️

Requisição

Resposta

⚠️Atenção:

⚠️
Atenção: