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

ℹ️

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

Veja uma requisição de transação no valor de R$100,00, com captura automática, sem o nó contendo as regras de divisão.

Taxa Split: 2% MDR + R$0,10 Tarifa Fixa.

Neste caso, o master recebe o valor da transação descontado o MDR acordado com o Split. Como apresentado anteriormente, a Tarifa Fixa acordada entre o master e o Split é sensibilizada diretamente na agenda de ambas as partes.

Master:

  • Crédito de R$98,00 (R$100,00 da transação menos R$2,00 de MDR do Split);
  • Débito de R$0,10 (Tarifa Fixa acordada com o Split de Pagamento).

O total a receber pelo master será R$97,90.

Split de Pagamento:

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

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

O valor total a receber pelo master está representado 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.

Requisição

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

--header "Authorization: Bearer {access_token}"

{  
   "merchantorderid":"22082019v1",
   "customer": {
        "Name": "Comprador Accept",
        "email": "[email protected]",
        "Identity": "12750233713",
        "identitytype": "CPF",
        "Mobile": "5521996660078",
        "Phone": "552125553669",
        "DeliveryAddress": {
            "Street": "Alameda Xingu",
            "Number": "512",
            "Complement": "27 andar",
            "ZipCode": "12345987",
            "City": "São Paulo",
            "State": "SP",
            "Country": "BR",
            "District": "Alphaville"
        }
    },
    "payment": {
        "type": "splittedcreditcard",
        "amount": 10000,
        "capture": true,
        "installments": 1,
        "softdescriptor": "teste",
        "CreditCard": {
            "cardNumber": "4481530710186111",
            "holder": "Oswaldo Soares",
            "ExpirationDate": "12/2019",
            "SecurityCode": "693",
            "Brand": "Visa",
            "SaveCard": "false"
        }
    }
}

Parâmetros no header:

PropriedadeTipoTamanhoObrigatórioDescrição
Authorization
Bearer:access_token
String--SimToken de acesso.

Informe o access_token obtido para a autenticação OAuth2

Parâmetros no body:

PropriedadesTipoTamanhoObrigatórioDescrição
MerchantOrderIdTexto50SimNumero de identificação do Pedido
Customer.EmailTexto255NãoEmail do comprador
Customer.NameTexto255SimNome do comprador
Customer.IdentityTexto14NãoNúmero do CPF ou CNPJ do Cliente. Permite envio de CNPJs alfanuméricos.
Customer.IdentityTypeTexto255NãoTipo de documento de identificação do comprador (CPF ou CNPJ)
Customer.MobileTexto14NãoCelular do comprador
Customer.PhoneTexto14NãoTelefone do comprador
Customer.DeliveryAddress.StreetTexto255NãoEndereço do comprador
Customer.DeliveryAddress.NumberTexto15NãoNúmero do endereço de entrega do pedido
Customer.DeliveryAddress.ComplementTexto50NãoComplemento do endereço de entrega do pedido
Customer.DeliveryAddress.ZipCodeTexto9NãoCEP do endereço de entrega do pedido
Customer.DeliveryAddress.CityTexto50NãoCidade do endereço de entrega do pedido
Customer.DeliveryAddress.StateTexto2NãoEstado do endereço de entrega do pedido
Customer.DeliveryAddress.CountryTexto35NãoPais do endereço de entrega do pedido
Customer.DeliveryAddress.DistrictTexto50NãoBairro do Comprador.
Payment.TypeTexto100SimTipo do meio de pagamento. Para transação de cartão de crédito, use splittedcreditcard. Tamanho: 100.
Payment.AmountNúmero15SimValor do pedido (ser enviado em centavos)
Payment.InstallmentsNúmero2SimNúmero de parcelas
Payment.CaptureBooleano
Não (Default false)Booleano que indica se a autorização deve ser com captura automática (true) ou não (false). Deverá verificar junto à adquirente a disponibilidade desta funcionalidade
Payment.SoftDescriptorTexto13NãoTexto que será impresso na fatura do portador. Na fatura, o sofdescriptor pode ser encurtado de acordo com as regras da adquirente e bandeira.
CreditCard.CardNumberTexto19SimNúmero do cartão do comprador
CreditCard.HolderTexto25SimNome do portador impresso no cartão
CreditCard.ExpirationDateTexto7SimData de validade impresso no cartão
CreditCard.SecurityCodeTexto4SimCódigo de segurança impresso no verso do cartão
CreditCard.BrandTexto10SimBandeira do cartão
CreditCard.SaveCardBooleano
Não (Default false)Booleano que identifica se o cartão será salvo para gerar o token (CardToken)
Payment.ExternalAuthentication.CavvTexto--NãoAssinatura retornada nos cenários de sucesso na autenticação.
⚠️Este campo é obrigatório para transações que foram autenticadas pelo emissor ou pela bandeira e nas solicitações de autorizações com Data Only.
Payment.ExternalAuthentication.XidTexto28NãoCampo obrigatório somente quando a versão do 3DS for "2' ou superior. XID retornado no processo de autenticação.
Payment.ExternalAuthentication.EciNúmero1NãoElectronic Commerce Indicator retornado no processo de autenticação.
Payment.ExternalAuthentication.VersionTexto5NãoCampo obrigatório para transações com autenticação 3DS.
Versão do 3DS aplicado no processo de autenticação.
Valores possíveis:
- Visa e Mastercard: "2.2.0"
- Elo e Amex: "2.1.0"
Payment.ExternalAuthentication.ReferenceIdTexto36NãoCampo obrigatório somente quando a versão do 3DS for "2' ou superior. RequestID retornado no processo de autenticação.
Payment.ExternalAuthentication.DataOnlyBooleano--NãoDefine se é uma transação com autenticação 3DS do tipo Data Only. O envio é obrigatório no caso de transação Data Only.

Resposta

{
    "MerchantOrderId": "22082019v3",
    "Customer": {
        "Name": "Comprador Accept",
        "Identity": "12750233713",
        "IdentityType": "CPF",
        "Email": "[email protected]",
        "DeliveryAddress": {
            "Street": "Alameda Xingu",
            "Number": "512",
            "Complement": "27 andar",
            "ZipCode": "12345987",
            "City": "São Paulo",
            "State": "SP",
            "Country": "BR",
            "District": "Alphaville"
        },
        "Phone": "552125553669",
        "Mobile": "5521996660078"
    },
    "Payment": {
        "ServiceTaxAmount": 0,
        "Installments": 1,
        "Interest": 0,
        "Capture": true,
        "Authenticate": false,
        "Recurrent": false,
        "CreditCard": {
            "CardNumber": "448153******6111",
            "Holder": "Oswaldo Soares",
            "ExpirationDate": "12/2019",
            "SaveCard": false,
            "Brand": "Visa"
        },
        "Tid": "0823032853370",
        "ProofOfSale": "20190823032853370",
        "AuthorizationCode": "023609",
        "SoftDescriptor": "teste",
        "Provider": "Simulado"
    },
    "SplitPayments": [
        {
            "SubordinateMerchantId": "f43fca07-48ec-46b5-8b93-ce79b75a8f63",
            "Amount": 10000,
            "Fares": {
                "Mdr": 2.00,
                "Fee": 10
            },
            "Splits": [
                {
                    "MerchantId": "f43fca07-48ec-46b5-8b93-ce79b75a8f63",
                    "Amount": 10000
                }
            ]
        }
    ],
    "IsQrCode": false,
    "Amount": 10000,
    "ReceivedDate": "2019-08-23 15:28:44",
    "CapturedAmount": 10000,
    "CapturedDate": "2019-08-23 15:28:53",
    "Status": 2,
    "IsSplitted": true,
    "ReturnMessage": "Operation Successful",
    "ReturnCode": "6",
    "PaymentId": "6b355eb8-d3bd-428d-ba4a-506f299a425f",
    "Type": "SplittedCreditCard",
    "Currency": "BRL",
    "Country": "BRA",
    "Links": [
        {
            "Method": "PUT",
            "Rel": "split",
            "Href": "https://splitsandbox.braspag.com.br/api/transactions/6b355eb8-d3bd-428d-ba4a-506f299a425f/split"
        },
        {
            "Method": "GET",
            "Rel": "self",
            "Href": "https://apiquerysandbox.cieloecommerce.cielo.com.br/1/sales/6b355eb8-d3bd-428d-ba4a-506f299a425f"
        },
        {
            "Method": "PUT",
            "Rel": "void",
            "Href": "https://apisandbox.cieloecommerce.cielo.com.br/1/sales/6b355eb8-d3bd-428d-ba4a-506f299a425f/void"
        }
    ]
}