Consultar listas de recorrência

Retorna todos os contratos de recorrência de forma paginada a partir das informações do pagador.

AmbienteMétodoEndpoint
SandboxGEThttps://api2.cielo.com.br/sandbox/cielo-pix/v1/rec
ProduçãoGEThttps://api-mtls.cielo.com.br/cielo-pix/v1/rec

AS periodicidades possíveis são:

  • Semanal;
  • Mensal;
  • Trimestral;
  • Semestral;
  • Anual.

Política de retentativa

PolíticaDefinição
NÃO_PERMITENão será autorizado retentativas após o vencimento
PERMITE_3R_7DSerá permitida até 3 tentativas após o vencimento dentro de 7 dias corridos

Status de recorrência

StatusDefinição
CRIADARecorrência criada pelo usuário recebedor
ENVIADARecorrência enviada ao PSP do pagador
RECEBIDARecorrência recebida pelo PSP do pagador
REJEITADARecorrência rejeitada pelo usuário pagador, apenas para a jornada 1, via notificação
ACEITARecorrência aceita pelo usuário pagador
EXPIRADAData da vigência da recorrência já expirada
CANCELADARecorrência cancelada pelo usuário pagador ou recebedor

Tipo de jornada

tipoJornadaDefinição
JORNADA_1Usuário pagador aceitou a recorrência através de notificação externa ao ecossistema
JORNADA_2Usuário pagador aceitou a recorrência através de leitura de QR Code de recorrência
JORNADA_3Usuário pagador iniciou a recorrência através de leitura de QR Code composto e pagamento de cobrança imediata. O uso desta jornada torna obrigatório o preenchimento de dadosJornada.txid
AGUARDANDO_DEFINICAOValor inicial posterior à criação e anterior à ativação da recorrência

Os possíveis solicitantes de cancelamento da cobrança recorrente são:

  • PSP_PAGADOR
  • USUARIO_PAGADOR
  • PSP_RECEBEDOR
  • USUARIO_RECEBEDOR

Códigos de cancelamento

CódigoDescrição
ACCLFechamento de conta. Utilizado para transações relacionadas ao encerramento de uma conta bancária.
CPCLEncerramento da empresa.
DCSDCancelamento por motivo de falecimento
FRUDUtilizado para transações que foram identificadas como fraudulentas
SLCRSolicitado pelo usuário pagador
SLDBSolicitado pelo usuário recebedor