post https://apisandbox.cieloecommerce.cielo.com.br/1/sales/
Cria um pagamento recorrente de cartão de crédito na modalidade Recorrência Programada.
| Ambiente | Método | Endpoint |
|---|---|---|
| Sandbox | post | https://apisandbox.cieloecommerce.cielo.com.br/1/sales/ |
| Produção | post | https://api.cieloecommerce.cielo.com.br/1/sales/ |
Saiba mais sobre essa funcionalidade na documentação.
Para recorrência programada, envie
AuthorizeNowcomo true.
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 |
|---|---|---|---|
ProofOfSale | Número da autorização, idêntico ao NSU. | string | 6 |
Tid | Identificador da transação na adquirente. | string | 20 |
AuthorizationCode | Código de autorização. | string | 6 |
PaymentId | Número de identificação do pagamento. O PaymentId será usado em futuras operações como consulta, captura e cancelamento. | GUID | 36 |
Status | Status da Transação. Veja a tabela completa de Status transacional | byte | *** |
ReturnCode | Código de retorno. | string | 32 |
ReturnMessage | Mensagem de retorno. | string | 512 |
Payment.MerchantAdviceCode | 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 |
Payment.CreditCard.PaymentAccountReference | 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 |
RecurrentPaymentId | Campo Identificador da próxima recorrência. | GUID | 36 |
NextRecurrency | Data da próxima recorrência. | string | 7 |
EndDate | Data de término da recorrência. | string | 7 |
Interval | Intervalo entre as recorrências. | integer | 10 |
AuthorizeNow | Booleano para saber se a primeira recorrência já vai ser autorizada ou não. | boolean | *** |