Authorize a recurring payment with a credit card
Environment | Method | Endpoint |
|---|---|---|
Sandbox | post |
|
Production | post |
|
Add the RecurrentPayment node to the Payment node to configure a recurrence when authorizing a transaction for the first time in the series of recurrences.
Alphanumeric CNPJs will be implemented by the Brazilian Federal Revenue Service in July 2026This change applies only to new registrations. There will be no changes to existing CNPJs.
The alphanumeric CNPJ is already supported by Cielo, with no changes required to your integration.
We recommend checking whether adjustments are needed in your merchant’s own checkout systems.
Card brand identifiers: in scheduled recurrence, the
IssuerTransactionIdandTransactionLinkIdfields are sent automatically in subsequent transactions. In sandbox, these fields are only returned with theSimuladoprovider and an authorized transaction scenario. See more details in Brand identifiers for Cielo acquirer.
Stored credential transaction identifiers
According to card brand rules, recurring transactions and those with stored credentials may require additional identification fields, such as IssuerTransactionId and TransactionLinkId. See more details below.
Card brand identifier: IssuerTransactionId
IssuerTransactionIdThe card brand identifier is an identification code for recurring or stored credential transactions, returned in the authorization response or in the card verification response (VerifyCard). See more details in IssuerTransactionId.
TLID Mastercard
The Transaction Link Identifier (TLID), sent and returned in the TransactionLinkId field, is a unique identifier generated by the Mastercard card brand during a CIT, used to link related MITs. The TLID applies to the VerifyCard response (response only) and to credit, debit, and recurring transactions.
For Mastercard, send IssuerTransactionId and TransactionLinkId together in MITs: both parameters are mandatory.
| Phase | Description |
|---|---|
| Phase 1 | Current. The TransactionLinkId field is available in the responses of VerifyCard by card number, credit card payment creation, debit card payment creation, and in the query by PaymentId. |
| Phase 2 | Required inclusion of the TransactionLinkId in the request (MIT) starting Oct 23, 2026. |
Scheduled recurrence: in subsequent transactions, the
IssuerTransactionIdandTransactionLinkIdfields are sent automatically.
The TransactionLinkId sent in the request must have exactly 22 characters (A-Z, a-z, 0-9, hyphen, and underscore). If the value is outside this format, Cielo ignores it without returning an error. When Cielo sends the TLID to the card brand, the response also includes SentTransactionLinkId, with the value that was sent. The VerifyCard request does not accept the field.
See more details in Brand identifiers for Cielo acquirer.
Recurring payment transaction response
The following table presents the main parameters that can be returned by the API when creating a recurring payment.
Property | Description | Type | Size |
|---|---|---|---|
| ID that represents the recurrence, used for future queries and changes. | string | 36 |
| Date when the next recurrence will occur. | string | 10 |
| Date when the recurrence ends. | string | 10 |
| Interval between recurrences. | string | 10 |
| Defines whether the first recurrence will be authorized immediately or not. | boolean | |
| Mastercard account status feedback
| string | |
| Transaction identifier generated by the card brand and returned in the CIT response. Store the value to send it in subsequent MITs: sending is mandatory, for all card brands, in recurring, incremental, and re-authorized transactions. See more details in Brand identifiers for Cielo acquirer. | string | 30 |
| Unique identifier (TLID) generated by Mastercard and returned in the response, used to link the CIT to subsequent MITs. For Mastercard, send the original | string | 22 |
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 | *** |
Acquirer Rede
- For the Rede2 provider, the response will return the
BrandTransactionId, which is the identifier of recurring transactions with the flags at the Rede acquirer.- For each new transaction in the sequence of recurrences, the
BrandTransactionIdmust be entered.- For Visa or Elo brands, enter the
BrandTransactionIdreceived in the first transaction.- For Mastercard, enter the
BrandTransactionIdreceived on the first or previous transaction.- The value of the
BrandTransactionIdwill be new with each recurring transaction response.