Create a recurrent payment

Environment	Method	Endpoint
Sandbox	post	`https://apisandbox.cieloecommerce.cielo.com.br/1/sales/`
Production	post	`https://api.cieloecommerce.cielo.com.br/1/sales/`

Guidelines for creating recurring transactions in sandbox:

The card must end in 0, 1, or 4;
Card must be valid according to mod10 (Luhn Algorithm), as the recurring transaction stores the card in a tokenized form.

⚠️
Identification of transactions originating from payment links for Elo cards
Starting October 17, 2025, it will be mandatory to identify transactions originating from payment links for Elo-branded cards. Send the parameter Payment.SolutionType = "ExternalLinkPay".

Recurring credit card transaction response

The table below presents the main parameters that can be returned by the API when creating a recurring credit card payment. The response will also contain the data provided during the creation of the recurring payment.

Property	Description	Type	Size
`ProofOfSale`	Authorization number, identical to NSU.	string	6
`Tid`	Transaction identifier at the acquirer.	string	20
`AuthorizationCode`	Authorization code.	string	6
`PaymentId`	Payment identification number. The `PaymentId` will be used in future operations such as query, capture, and cancellation.	GUID	36
`Status`	Transaction status. See the complete table of transactional status.	byte
`ReturnCode`	Return code.	string	32
`ReturnMessage`	Return message.	string	512
`Payment.MerchantAdviceCode`	Return code from the card brand that defines retry period. Valid only for Mastercard. Learn more Card brands retry program for Mastercard.	string	2
`Payment.CreditCard.PaymentAccountReference`	The PAR (Payment Account Reference) is the number that associates different tokens with the same card. It will be returned by Master and Visa brands and passed on to Cielo e-commerce customers. If the brand does not send the information, the field will not be returned.	string	29
`RecurrentPaymentId`	Field identifier of the next recurrence.	GUID	36
`NextRecurrency`	Date of the next recurrence.	string	7
`EndDate`	End date of the recurrence.	string	7
`Interval`	Interval between recurrences.	integer	10
`AuthorizeNow`	Boolean to know if the first recurrence will be authorized or not.	boolean
`CardBrandStatus`	Mastercard account status feedback VALID: Valid card or no updates on base UNKNOWN: Card not available at ABU NON_PARTICIPATING: Card not available at ABU ACCOUNT_CLOSED: Card is closed UPDATE: vUpdate plastic or expiration EXPIRY: Validity update ERROR: There was an error in the update (Timeout for example) Find out more in the documentation	string

Fields returned by Renova Fácil

Propriedade	Descrição	Tipo	Tamanho
`NewCard.CardNumber`	Shopper's new card number.	string	16
`NewCard.ExpirationDate`	New expiry date of the card.	string	7
`NewCard.Brand`	Card brand.	string	10
`NewCard.SaveCard`	Identifies whether the card generated `Cardtoken` during the transaction. Find out more about Tokenization of Cards	booleano