Cielo - Pagamento com Token

Cria um pagamento usando um cartão tokenizado na Cielo

Cielo - Pagamento com Token

AI-generated

Summary

Create a credit card payment on the Cielo platform using a stored card token, optionally as a recurring payment.

Inputs

  • Merchant Order ID (required) — Unique identifier for the order.
  • Valor (em centavos ou reais) (required) — Amount to be charged, provided in either centavos or reais; values under 1000 are treated as reais and multiplied by 100.
  • Nome do Cliente — Customer's full name.
  • Documento (CPF ou CNPJ) — Customer's identification number (CPF or CNPJ).
  • Tipo de Documento — Type of identification document used by the customer, either CPF or CNPJ.
  • CardToken (required) — Card token previously generated by the "Cielo - Tokenizar Cartão" node; must be valid for the credential environment.
  • CVV (required) — Credit card security code (CVV).
  • Bandeira (required) — Credit card brand (Visa, Master, Amex, Elo, Diners).
  • Recorrente? — Flag to indicate if the payment is recurring.
  • Configuração de Recorrência — Recurring payment settings including authorization timing, start and end dates, and interval frequency (monthly, bimonthly, quarterly, semiannual, annual). Must be provided if Recorrente? is true.

Output shape

A single JSON object containing details about the payment response, including paymentId, status, returnCode, returnMessage, amount, and the raw API response.

The operation requires valid Cielo API credentials and card token generated in the same environment and merchant affiliation. Errors related to token validity provide hints for troubleshooting. Amounts less than 1000 are treated as reais and converted to centavos automatically.

Examples

Example 1: Charge a credit card once using an existing card token.

Set Merchant Order ID, amount (in reais or centavos), card token, CVV, brand, and optionally customer name and document details.

Example 2: Create a recurring payment starting on a specific date.

Set Recorrente? to true and configure recurring options including start date, interval, and authorization timing.

Discussion