Consultar recorrência

Consulta uma transação recorrente informando o RecurrentPaymentId

AmbienteMétodoEndpoint
Sandboxhttps://apiquerysandbox.cieloecommerce.cielo.com.br/1/RecurrentPayment/{RecurrentPaymentId}
Produçãohttps://apiquery.cieloecommerce.cielo.com.br/1/RecurrentPayment/{RecurrentPaymentId}

ℹ️

Saiba mais sobre essa funcionalidade na documentação.

ℹ️

Apenas as transações dentro dos últimos três meses podem ser consultadas via API.

  • O RecurrentPaymentId é a identificação do pedido recorrente retornado na criação do pagamento com recorrência;
  • A consulta por RecurrentPaymentId irá retornar todos os detalhes da transação recorrente.

Resposta da consulta de pedido recorrente

A tabela a seguir apresenta os principais parâmetros que podem ser retornados pela API na consulta de um pedido recorrente.

PropriedadeDescriçãoTipoTamanho
InstallmentsNúmero de parcelas.intenger2
RecurrentPaymentIdID que representa a recorrência, utilizada para consultas e alterações futuras.string36
NextRecurrencyData de quando acontecerá a próxima recorrência.string10
StartDateData para início da recorrência.string10
EndDateData do fim da recorrência.string10
IntervalIntervalo entre as recorrências.string10
CurrentRecurrencyTryNúmero atual da tentativa de recorrência.integer1
RecurrencyDayDia da recorrência.integer2
SuccessfulRecurrencesQuantidade de recorrências realizadas com sucesso.integer2
Path Params
string
required

Campo Identificador da Recorrência. Tamanho: 36.

Headers
string
required
Defaults to 8937bd5b-9796-494d-9fe5-f76b3e4da633

Identificador da loja na Cielo. Tamanho: 36. Formato: GUID.
Esta documentação traz um MerchantId padrão para permitir os testes em sandbox, mas você também pode informar o MerchantId habilitado durante o processo de implantação.

string
required
Defaults to XKGHUBSBKIRXKAVPSKWLVXYCLVJUGTNZLIHPUSYV

Chave pública para autenticação dupla na Cielo. Tamanho: 40. Formato: GUID.
Esta documentação traz um MerchantKey padrão para permitir os testes em sandbox, mas você também pode informar o MerchantKey habilitado durante o processo de implantação.

string

Identificador do Request, utilizado quando o lojista usa diferentes servidores para cada GET/POST/PUT. Tamanho: 36.

Response

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json