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.


Requisição

Ambiente

Método

Endpoint

Sandbox

https://apisandbox.cieloecommerce.cielo.com.br/1/sales

Produção

https://api.cieloecommerce.cielo.com.br/1/sales


{  
   "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"
        }
    }
}

A seguir, veja os campos de propriedade nesta requisição:

Propriedade (header)TipoTamanhoObrigatórioDescrição
MerchantIdGuid36SimIdentificador da loja no Split de Pagamento
MerchantKeyTexto40SimChave Publica para Autenticação Dupla no Split de Pagamento
Content-TypeHeader40SimApplication/json

Parâmetros (body)

Tipo

Tamanho

Obrigatório

Descrição

MerchantOrderId

Texto

50

Sim

Numero de identificação do Pedido

Customer.Email

Texto

255

Não

Email do comprador

Customer.Name

Texto

255

Sim

Nome do comprador

Customer.Identity

Texto

14

Não

Número do RG, CPF ou CNPJ do Cliente

Customer.IdentityType

Texto

255

Não

Tipo de documento de identificação do comprador (CPF ou CNPJ)

Customer.Mobile

Texto

14

Não

Celular do comprador

Customer.Phone

Texto

14

Não

Telefone do comprador

Customer.DeliveryAddress.Street

Texto

255

Não

Endereço do comprador

Customer.DeliveryAddress.Number

Texto

15

Não

Número do endereço de entrega do pedido

Customer.DeliveryAddress.Complement

Texto

50

Não

Complemento do endereço de entrega do pedido

Customer.DeliveryAddress.ZipCode

Texto

9

Não

CEP do endereço de entrega do pedido

Customer.DeliveryAddress.City

Texto

50

Não

Cidade do endereço de entrega do pedido

Customer.DeliveryAddress.State

Texto

2

Não

Estado do endereço de entrega do pedido

Customer.DeliveryAddress.Country

Texto

35

Não

Pais do endereço de entrega do pedido

Customer.DeliveryAddress.District

Texto

50

Não

Bairro do Comprador.

Payment.Type

Texto

100

Sim

Tipo do meio de pagamento. Para transação de cartão de crédito, use splittedcreditcard. Tamanho: 100.

Payment.Amount

Número

15

Sim

Valor do pedido (ser enviado em centavos)

Payment.Installments

Número

2

Sim

Número de parcelas

Payment.Capture

Booleano


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.SoftDescriptor

Texto

13

Não

Texto que será impresso na fatura do portador. Na fatura, o sofdescriptor pode ser encurtado de acordo com as regras da adquirente e bandeira.

CreditCard.CardNumber

Texto

19

Sim

Número do cartão do comprador

CreditCard.Holder

Texto

25

Sim

Nome do portador impresso no cartão

CreditCard.ExpirationDate

Texto

7

Sim

Data de validade impresso no cartão

CreditCard.SecurityCode

Texto

4

Sim

Código de segurança impresso no verso do cartão

CreditCard.Brand

Texto

10

Sim

Bandeira do cartão

CreditCard.SaveCard

Booleano


Não (Default false)

Booleano que identifica se o cartão será salvo para gerar o token (CardToken)

Payment.ExternalAuthentication.Cavv

Texto

--

Não

Assinatura 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.Xid

Texto

28

Não

  • *Campo obrigatório somente quando a versão do 3DS for "2' ou superior.** XID retornado no processo de autenticação.

Payment.ExternalAuthentication.Eci

Número

1

Não

  • Electronic Commerce Indicator_ retornado no processo de autenticação.

Payment.ExternalAuthentication.Version

Texto

5

Não

  • *Campo 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.ReferenceId

Texto

36

Não

  • *Campo obrigatório somente quando a versão do 3DS for "2' ou superior.** RequestID retornado no processo de autenticação.

Payment.ExternalAuthentication.DataOnly

Booleano

--

Não

Define 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"
        }
    ]
}