Criar pagamento com cartão multibenefícios

Cria solicitação de autorização para transação de cartão multibenefícios.

AmbienteMétodoEndpoint
Sandboxhttps://apisandbox.cieloecommerce.cielo.com.br/1/sales
Produçãohttps://api.cieloecommerce.cielo.com.br/1/sales
ℹ️

Saiba mais sobre essa funcionalidade na documentação.

ℹ️

CNPJs alfanuméricos serão implementados pela Receita Federal em julho de 2026

Essa mudança afeta apenas novas inscrições, não havendo mudanças em CNPJs existentes.

O CNPJ alfanumérico já está sendo suportado pela Cielo, sem mudanças na sua integração.

Recomendamos verificar a necessidade de possíveis ajustes nos sistemas próprios de checkout de sua loja.

O pagamento com cartão multibenefícios é semelhante a um pagamento de cartão de crédito.

  • Envie os dados do cartão no nó Payment.CreditCard;
  • Informe Voucher = true.
  • Bandeiras aceitas: Visa, Mastercard e Elo.
ℹ️

Captura e cancelamento

  • É possível fazer a captura posterior;
  • É permitido cancelar a transação dentro do prazo de 360 dias.
⚠️

Atenção

Para voucher multibenefícios Alelo, use a integração do tipo voucher.


Body Params
string
required

Identificação do pedido. Poderá ser usada para cancelar ou consultar a transação no futuro.
Atenção: Os caracteres permitidos são apenas a-z, A-Z, 0-9. Não são permitidos caracteres especiais e espaços em branco.
Tamanho: 50.

Customer
object
Payment
object
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 da requisição, usado quando a loja usa diferentes servidores para cada GET/POST/PUT. Tamanho: 36.

Responses

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