Criar transação de crédito com o nó da divisão

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

ℹ️

As características de uma transação de crédito são:

  • Envie o Payment.Type como "SplittedCreditCard";
  • Envie o nó Payment.CreditCard;
  • Se a transação passar por análise de fraude, envie o nó Payment.FraudAnalysis. Confira exemplo da transação de crédito com análise de fraude no manual do Gateway;
  • Envio de taxas na requisição: Se a requisição incluir taxas, essas terão prioridade sobre as taxas cadastradas no portal e-commerce. As taxas do portal e-commerce só serão aplicadas quando nenhuma taxa for enviada ou em casos de redivisão.

A requisição a seguir corresponde a uma transação no valor de R$100,00 com o nó contendo as regras de divisão. Neste exemplo foram assumidas as seguintes taxas:

Taxa Split: 2% MDR + R$0,10 Tarifa Fixa.
Taxa master com o seller A: 5% MDR (embutindo os 2% do MDR Split de Pagamento) + 0,30 Tarifa Fixa.
Taxa master com o seller B: 4% MDR (embutindo os 2% do MDR Split de Pagamento) + 0,15 Tarifa Fixa.

Seller A:

  • Crédito de R$57,00 (R$60,00 da transação menos R$3,00 de MDR);
  • Débito de R$0,30 de Tarifa Fixa.

O total a receber pelo seller A será R$56,70.

Seller B:

  • Crédito de R$38,40 (R$40,00 da transação menos R$1,60 de MDR);
  • Débito de R$0,15 de Tarifa Fixa.

O total a receber pelo seller B será R$38,25.

Master:

Crédito de R$3,05 (R$3,00 de MDR + R$0,30 de Tarifa Fixa do seller A, somados com R$1,60 de MDR + R$0,15 de Tarifa Fixa do seller B, menos R$2,00 de MDR Split de Pagamento);
Débito de R$0,10 (Tarifa Fixa acordada com a Split de Pagamento).

O total a receber pelo Master será R$2,95.

Split:

  • Crédito de R$2,10 (R$2,00 de MDR aplicado sobre o valor total da transação mais R$0,10 de Tarifa Fixa acordada com o Master).

O total a receber pelo Split de Pagamento será R$2,10.

As divisões e o valor total a receber de cada participante estão na figura a seguir.

ℹ️

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.

Visa Intelligent Data Exchange (IDX)

Caso use o serviço de autenticação IDX da Visa, veja Visa Intelligent Data Exchange (IDX)

Body Params
string
required

Numero de identificação do Pedido. Tamanho: 50.

Customer
object
Payment
object
Headers
string
required
Defaults to {access_token}

Informe o access_token obtido para a autenticação OAuth2

Response

Language
Credentials
OAuth2
LoadingLoading…
Response
Choose an example:
application/json