| Ambiente | Método | Endpoint |
|---|---|---|
| Sandbox | post | https://apisandbox.braspag.com.br/v2/sales |
| Produção | post | https://api.braspag.com.br/v2/sales |
Para submeter uma transação do Gateway de Pagamentos ao Split de Pagamento, basta enviar o ParâmetroPayment.DoSplitcomo true e adicionar o nóPayment.SplitPayments.
As características de uma transação de crédito são:
- Envie o
Payment.Typecomo "CreditCard";- 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.
O exemplo 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 de Pagamento: 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);
Débito de R$0,10 (Tarifa Fixa acordada com o Split).
O total a receber pelo Master será R$2,95.
Split de Pagamento:
- 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 será R$2,10.
Veja a requisição dessa transação no valor de R$100,00 com o nó contendo as regras de divisão.
CNPJs alfanuméricos serão implementados pela Receita Federal em julho de 2026Essa 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)
TLID Mastercard
O Transaction Link Identifier (TLID), enviado e retornado no campo TransactionLinkId, é um identificador único gerado pela bandeira Mastercard durante uma transação CIT, usado para vincular as transações MIT relacionadas. O TLID vale para a resposta do VerifyCard (apenas resposta) e para as transações de crédito, débito e recorrência.
Na Mastercard, envie IssuerTransactionId e TransactionLinkId juntos nas transações MIT: os dois parâmetros são obrigatórios.
| Fase | Descrição |
|---|---|
| Fase 1 | Vigente. O campo TransactionLinkId está disponível na resposta da validação de cartão por VerifyCard, criação de pagamento com cartão de crédito, criação de pagamento com cartão de débito e na consulta por PaymentId. |
| Fase 2 | Envio obrigatório do TransactionLinkId no request (MIT) a partir de 23/10/2026. |
Recorrência programada: nas transações seguintes, os campos
IssuerTransactionIdeTransactionLinkIdsão enviados automaticamente.
O TransactionLinkId enviado no request deve ter exatamente 22 caracteres (A-Z, a-z, 0-9, hífen e sublinhado). Se o valor estiver fora desse formato, a Cielo o ignora, sem retornar erro. Quando a Cielo envia o TLID à bandeira, a resposta traz também o SentTransactionLinkId, com o valor enviado. O request do VerifyCard não aceita o campo.
Saiba mais em Identificadores da bandeira para adquirente Cielo.
Resposta da transação de cartão de crédito
A tabela a seguir apresenta os parâmetros de identificadores da bandeira que podem ser retornados pela API.
| Propriedade | Descrição | Tipo | Tamanho |
|---|---|---|---|
Payment.IssuerTransactionId | Identificador da transação gerado pela bandeira e retornado na resposta da transação CIT. Armazene o valor para enviá-lo nas transações MIT seguintes: o envio é obrigatório, para todas as bandeiras, em transações recorrentes, incrementais e reautorizadas. Consulte mais informações em Identificadores da bandeira para adquirente Cielo. | Texto | 30 |
Payment.TransactionLinkId | Identificador único (TLID) gerado pela Mastercard e retornado na resposta, usado para vincular a transação CIT às transações MIT seguintes. Na Mastercard, envie o Formato: 22 caracteres alfanuméricos (A-Z, a-z), com diferenciação entre maiúsculas e minúsculas e podem incluir hífens (-) e sublinhados (_). | Texto | 22 |
Payment.SentTransactionLinkId | TLID que o estabelecimento enviou no request e que a Cielo repassou à bandeira. O campo só aparece quando a Cielo enviou o TLID. Consulte mais informações em Identificadores da bandeira para adquirente Cielo. | Texto | 22 |