Cria um pagamento recorrente de cartão de crédito na modalidade Recorrência Programada.
Ambiente | Método | Endpoint |
|---|---|---|
Sandbox | post |
|
Produção | post |
|
Saiba mais sobre essa funcionalidade na documentação.
Para recorrência programada, envie
AuthorizeNowcomo true.
CNPJs alfanuméricos serão implementados pela Receita Federal em julho de 2026Essa mudança afeta apenas novas inscrições, não havendo mudanças em CNPJs existentes.
O CNPJ alfanumérico já está sendo suportado pela Cielo, sem mudanças na sua integração.
Recomendamos verificar a necessidade de possíveis ajustes nos sistemas próprios de checkout de sua loja.
Orientações para criar transação recorrente em sandbox:
- O cartão precisa ser final 0, 1 ou 4;
- O cartão precisa ser válido no mod10 (Algoritmo de Luhn), uma vez que a transação recorrente armazena o cartão de forma tokenizada.
Resposta da transação de cartão de crédito recorrente
A tabela a seguir apresenta os principais parâmetros que podem ser retornados pela API na criação de um pagamento com cartão de crédito com recorrência. A resposta também irá conter os dados informados na criação do pagamento recorrente.
Propriedade | Descrição | Tipo | Tamanho |
|---|---|---|---|
| Número da autorização, idêntico ao NSU. | string | 6 |
| Identificador da transação na adquirente. | string | 20 |
| Código de autorização. | string | 6 |
| Número de identificação do pagamento. | GUID | 36 |
| Status da Transação. Veja a tabela completa de Status transacional | byte | |
| Código de retorno. | string | 32 |
| Mensagem de retorno. | string | 512 |
| Código de retorno da bandeira que define período para retentativa. Válido somente para bandeira Mastercard. Saiba mais Programa de retentativa das bandeiras para Mastercard | string | 2 |
| O PAR (Payment Account Reference) é o número que associa diferentes tokens a um mesmo cartão. Será retornado pelas bandeiras Master e Visa e repassado para os clientes do e-commerce Cielo. Caso a bandeira não envie a informação, o campo não será retornado. | string | 29 |
| Campo Identificador da próxima recorrência. | GUID | 36 |
| Data da próxima recorrência. | string | 7 |
| Data de término da recorrência. | string | 7 |
| Intervalo entre as recorrências. | integer | 10 |
| Define se a primeira recorrência já irá ser autorizada ou não. | boolean | |
| Retorno de status da conta Mastercard
| string | |
| Identificador da transação gerado pela bandeira; deve ser enviado para referenciar a transação original/anterior em operações relacionadas, como em recorrências. Consulte mais informações em Identificadores da bandeira. | string | 30 |
| O Formato: 22 caracteres alfanuméricos (A-Z, a-z), com diferenciação entre maiúsculas e minúsculas e podem incluir hífens (-) e sublinhados (_). | string | 22 |
Campos retornados pelo Renova Fácil
Caso a loja tenha o Renova Fácil ou o ABU habilitado, e exista um novo cartão disponível, os dados atualizados serão retornados no nó NewCard da resposta.
Propriedade | Descrição | Tipo | Tamanho |
|---|---|---|---|
| Novo número do cartão do comprador. | string | 16 |
| Nova data de validade do cartão. | string | 7 |
| Bandeira do cartão. | string | 10 |
| Identifica se o cartão gerou | booleano |