| Ambiente | Método | Endpoint |
|---|---|---|
| Sandbox | POST | https://apisandbox.cieloecommerce.cielo.com.br/1/physicalSales/ |
| Homologação | POST | https://apisandbox.cieloecommerce.cielo.com.br/1/physicalSales/ |
| Produção | POST | https://api.cieloecommerce.cielo.com.br/1/physicalSales/ |
Requisição
{
"MerchantOrderId": "123456789123456",
"Customer": {
"Name": "Comprador crédito completo",
"Identity": "11225468954",
"IdentityType": "CPF",
"Email": "[email protected]",
"Birthday": "1991-01-02",
"Address": {
"Street": "Rua Teste",
"Number": "123",
"Complement": "AP 123",
"ZipCode": "12345987",
"City": "São Paulo",
"State": "SP",
"Country": "BRA"
},
"DeliveryAddress": {
"Street": "Rua Teste",
"Number": "123",
"Complement": "AP 123",
"ZipCode": "12345987",
"City": "São Paulo",
"State": "SP",
"Country": "BRA"
}
},
"Payment": {
"SubordinatedMerchantId": "{{SubordinatedMerchantId}}",
"Type": "PhysicalCreditCard",
"SoftDescriptor": "Teste API",
"PaymentDateTime": "2022-08-22T13:30:48",
"Amount": 400,
"Installments": 1,
"Interest": "ByMerchant",
"Capture": true,
"ProductId": 1,
"CreditCard": {
"CardNumber": "EC9A221AC2E165A7",
"BrandId": 1,
"IssuerId": 1001,
"ExpirationDate": "12/2021",
"SecurityCodeStatus": "Collected",
"SecurityCode": "123",
"EncryptedCardData": {
"EncryptionType": "Dukpt3DesCBC",
"InitializationVector": "0000000000000000",
"CardNumberKSN": "FFFFF99995C1B4400004"
},
"InputMode": "Typed",
"AuthenticationMethod": "NoPassword",
"TruncateCardNumberWhenPrinting": true,
"SaveCard": true
},
"PinPadInformation": {
"PhysicalCharacteristics": "PinPadWithChipReaderWithoutSamAndContactless",
"ReturnDataInfo": "00",
"SerialNumber": "0820471929",
"TerminalId": "00000001"
}
}
}| Propriedade | Tipo | Tamanho | Obrigatório | Descrição |
|---|---|---|---|---|
| MerchantOrderId | String | 15 | Sim | Número utilizado para identificação da transação e que deve ser gerado pela aplicação integrada com o Conecta. Aceita apenas valores numéricos de 1 a 15 dígitos e não pode ser duplicado. |
| Customer.Name | String | 255 | Não | Nome do comprador |
| Customer.Identity | String | 14 | Não | Numero do cpf ou cnpj do cliente |
| Customer.IdentityType | String | 255 | Não | Tipo de documento de identificação do comprador (CPF ou CNPJ) |
| Customer.Email | String | 255 | Não | Email do comprador |
| Customer.Birthday | String | 10 | Não | Data de nascimento do comprador no formato AAAA-MM-DD |
| Customer.Address.Street | String | 255 | Não | Endereço de contato do comprador |
| Customer.Address.Number | String | 15 | Não | Número do endereço de contato do comprador |
| Customer.Address.Complement | String | 50 | Não | Complemento do endereço de contato do comprador |
| Customer.Address.ZipCode | String | 9 | Não | CEP do endereço de contato do comprador |
| Customer.Address.City | String | 50 | Não | Cidade do endereço de contato do comprador |
| Customer.Address.State | String | 2 | Não | Estado do endereço de contato do comprador |
| Customer.Address.Country | String | 35 | Não | País do endereço de contato do comprador |
| Customer.DeliveryAddress.Street | String | 255 | Não | Endereço de entrega do comprador |
| Customer.DeliveryAddress.Number | String | 15 | Não | Número do endereço de entrega |
| Customer.DeliveryAddress.Complement | String | 50 | Não | Complemento do endereço de entrega |
| Customer.DeliveryAddress.ZipCode | String | 9 | Não | CEP do endereço de entrega |
| Customer.DeliveryAddress.City | String | 50 | Não | Cidade do endereço de entrega |
| Customer.DeliveryAddress.State | String | 2 | Não | Estado do endereço de entrega |
| Customer.DeliveryAddress.Country | String | 35 | Não | País do endereço de entrega |
| Payment.SubordinatedMerchantId | String | — | Sim | Código identificador da loja. |
| Payment.Type | String | — | Sim | Value: PhysicalCreditCard / Tipo da Transação |
| Payment.SoftDescriptor | String | 13 | Não | Identificação do estabelecimento (nome reduzido) a ser impresso e identificado na fatura. |
| Payment.PaymentDateTime | String | date-time | Sim | Data e Hora da captura da transação |
| Payment.Amount | Integer(int64) | 15 | Sim | Valor da transação (1079 = R$10,79) |
| Payment.Capture | Booleano | — | Não | Default: false / Booleano que identifica que a autorização deve ser com captura automática. A autorização sem captura automática é conhecida também como pré-autorização. |
| Payment.Installments | Integer | 2 | Sim | Default: 1 / Quantidade de Parcelas: Varia de 2 a 99 para transação de financiamento. Deve ser verificado os atributos MaximumNumberOfInstallmentsWhenFinancingByCreditCardCompany, MaximumNumberOfInstallmentsWhenFinancingByStore e MinimumNumberOfInstallmentsWhenFinancingByStore da objeto ProductEntry da baixa de parametros. |
| Payment.Interest | String | 10 | Não | Default: ByMerchant Enum: ByMerchant, ByIssuer Tipo de Parcelamento: - Se os campos AllowFinancingByStore presente nos objetos IssuerEntry, BinEntry e ProductEntry da baixa de parametros estiverem todos habilitados indica que o tipo de parcelamento sem juros pode ser efetuado. - Se os campos AllowFinancingByCreditCardCompany presente nos objetos IssuerEntry, BinEntry e ProductEntry da baixa de parametros estiverem todos habilitados indica que o tipo de parcelamento com juros pode ser efetuado. Sem juros = “ByMerchant”; Com juros = “ByIssuer”. |
| Payment.ProductId | Integer | — | Sim | Código do produto identificado através do bin do cartão. |
| Payment.CreditCard.CardNumber | String | 19 | Sim | Número do cartão (PAN) |
| Payment.CreditCard.ExpirationDate | String | MM/yyyy | Sim | Data de validade do cartão. Dado obtido através do comando PP_GetCard na BC no momento da captura da transação. |
| Payment.CreditCard.SecurityCodeStatus | String | — | Sim | Enum: Collected Unreadable Nonexistent Status da coleta de código de segurança (CVV) |
| Payment.CreditCard.SecurityCode | String | 5 | Sim | Código de segurança (CVV) |
| Payment.CreditCard.BrandId | Integer | — | Sim | Identificação da bandeira obtida através do campo BrandId da PRODUCT TABLE. |
| Payment.CreditCard.IssuerId | Integer | — | Sim | Código do emissor obtido através do campo IssuerId no objeto BinEntry da baixa de parametros. |
| Payment.CreditCard.InputMode | String | — | Sim | Enum: Typed, MagStripe, Emv, ContactlessEmv Identificação do modo de captura do cartão na transação. Essa informação deve ser obtida através do retorno da função PP_GetCard da BC. “00” – Magnético “01” - Moedeiro VISA Cash sobre TIBC v1 “02” - Moedeiro VISA Cash sobre TIBC v3 “03” – EMV com contato “04” - Easy-Entry sobre TIBC v1 “05” - Chip sem contato simulando tarja “06” - EMV sem contato. |
| Payment.CreditCard.AuthenticationMethod | String | — | Sim | Enum: NoPassword OnlineAuthentication OfflineAuthentication Método de autenticação - Se o cartão foi lido a partir da digitação verificar o campo RequiresPasswordExceptForEMVCard dos objetos BinEntry, ParameterEntry e IssuerEntry da baixa de parametros. Se todos estiverem habilitados, a senha deve ser capturada e o authenticationMethod assume valor 2. Caso contrário, assume valor 1; - Se o cartão foi lido a partir da trilha verificar o campo RequiresPassword dos objetos BinEntry, ParameterEntry e IssuerEntry da baixa de parametros. Se todos estiverem habilitados deve ser capturada a senha, se algum estiver desabilitado a captura da senha vai depender do último dígito do service code; - Se o cartão foi lido através do chip EMV, o authenticationMethod será preenchido com base no retorno da função PP_GoOnChip(). No resultado PP_GoOnChip(), onde se o campo da posição 003 do retorno da PP_GoOnChip() estiver com valor 1 indica que o pin foi validado off-line, o authenticationMethod será 3. Se o campo da posição 003 e o campo da posição 006 do retorno da PP_GoOnChip() estiverem com valor 0, o authenticationMethod será 1. Se o campo da posição 003 e o campo da posição 006 do retorno da PP_GoOnChip() estiverem com valores 0 e 1 respectivamente, o authenticationMethod será 2. 1 - Sem senha = “NoPassword”; 2 - Senha online = “Online Authentication”; 3 - Senha off-line = “Offline Authentication”. |
| Payment.CreditCard.TruncateCardNumberWhenPrinting | Booleano | — | Não | Indica se o número do cartão será truncado no momento da impressão do comprovante. A solução de captura deve tomar essa decisão com base no campo AllowPrintingPartialCardNumberInReceipt presente nos objetos BinEntry, ParameterEntry e IssuerEntry. |
| Payment.CreditCard.SaveCard | Booleano | — | Não | Identifica se vai salvar/tokenizar o cartão. |
| Payment.CreditCard.IsFallback | Booleano | — | Não | Identifica se é uma transação de fallback. |
| Payment.PinPadInformation.TerminalId | String | 8 | Sim | Número Lógico definido no Concentrador Cielo. |
| Payment.PinPadInformation.SerialNumber | String | 20 | Sim | Número de Série do Equipamento. |
| Payment.PinPadInformation.ReturnDataInfo | String | — | Sim | Retorno da função PP_GetInfo() da biblioteca compartilhada |
| Payment.CreditCard.EncryptedCardData.EncryptionType | String | — | Sim | Tipo de encriptação utilizada Enum: “DukptDes” = 1, “MasterKey” = 2 “Dukpt3Des” = 3, “Dukpt3DesCBC = 4 |
| Payment.CreditCard.EncryptedCardData.CardNumberKSN | String | — | Sim | Identificador KSN da criptografia do número do cartão |
| Payment.CreditCard.EncryptedCardData.IsDataInTLVFormat | Bool | — | Não | Identifica se os dados criptografados estão no formato TLV (tag / length / value). |
| Payment.CreditCard.EncryptedCardData.InitializationVector | String | — | Sim | Vetor de inicialização da encriptação |
Resposta
{
"MerchantOrderId": "123456789123456",
"Customer": {
"Name": "Comprador crédito completo",
"Identity": "11225468954",
"IdentityType": "CPF",
"Email": "[email protected]",
"Address": {
"Street": "Rua Teste",
"Number": "123",
"Complement": "AP 123",
"ZipCode": "12345987",
"City": "São Paulo",
"State": "SP",
"Country": "BRA"
},
"DeliveryAddress": {
"Street": "Rua Teste",
"Number": "123",
"Complement": "AP 123",
"ZipCode": "12345987",
"City": "São Paulo",
"State": "SP",
"Country": "BRA"
}
},
"Payment": {
"Installments": 1,
"Interest": "ByMerchant",
"Capture": true,
"CreditCard": {
"CardNumber": "EC9A221AC2E165A7",
"ExpirationDate": "12/2021",
"SecurityCodeStatus": "Collected",
"SecurityCode": "***",
"BrandId": 1,
"IssuerId": 1001,
"TruncateCardNumberWhenPrinting": true,
"InputMode": "Typed",
"AuthenticationMethod": "NoPassword",
"IsFallback": false,
"BrandInformation": {
"Type": "VENDA A CREDITO",
"Name": "VISA"
},
"SaveCard": true,
"EncryptedCardData": {
"EncryptionType": 4,
"CardNumberKSN": "FFFFF99995C1B4400004",
"InitializationVector": "0000000000000000",
"IsDataInTLVFormat": false
}
},
"Amount": 400,
"ReceivedDate": "2024-05-14T19:59:27Z",
"CapturedAmount": 400,
"CapturedDate": "2024-05-14T19:59:28Z",
"Provider": "Cielo",
"Status": 2,
"PhysicalTransactionStatus": 2,
"IsSplitted": false,
"ReturnMessage": "APROVADA 350441",
"ReturnCode": "000",
"PaymentId": "c1d7d163-0813-4383-8adc-63c66b320da7",
"Type": "PhysicalCreditCard",
"Currency": "BRL",
"Country": "BRA",
"Links": [
{
"Method": "GET",
"Rel": "self",
"Href": "https://apiquerysandbox.cieloecommerce.cielo.com.br/1/physicalSales/c1d7d163-0813-4383-8adc-63c66b320da7"
},
{
"Method": "PUT",
"Rel": "confirm",
"Href": "https://apisandbox.cieloecommerce.cielo.com.br/1/physicalSales/c1d7d163-0813-4383-8adc-63c66b320da7/confirmation"
},
{
"Method": "DELETE",
"Rel": "reverse",
"Href": "https://apisandbox.cieloecommerce.cielo.com.br/1/physicalSales/c1d7d163-0813-4383-8adc-63c66b320da7"
}
],
"PaymentDateTime": "2024-05-14T16:59:28.575Z",
"ServiceTaxAmount": 0,
"SoftDescriptor": "Teste API",
"ProductId": 1,
"PinPadInformation": {
"TerminalId": "00000001",
"SerialNumber": "0820471929",
"PhysicalCharacteristics": "PinPadWithChipReaderWithoutSamAndContactless",
"ReturnDataInfo": "00"
},
"PrintMessage": [],
"ReceiptInformation": [
{
"Field": "MERCHANT_NAME",
"Label": "NOME DO ESTABELECIMENTO",
"Content": "Loja Teste"
},
{
"Field": "MERCHANT_ADDRESS",
"Label": "ENDEREÇO DO ESTABELECIMENTO",
"Content": "Alameda Xingu, 512"
},
{
"Field": "MERCHANT_CITY",
"Label": "CIDADE DO ESTABELECIMENTO",
"Content": "BARUERI"
},
{
"Field": "MERCHANT_STATE",
"Label": "ESTADO DO ESTABELECIMENTO",
"Content": "SP"
},
{
"Field": "MERCHANT_CODE",
"Label": "COD.ESTAB.",
"Content": "0023137868169300"
},
{
"Field": "TERMINAL",
"Label": "POS",
"Content": "41786816"
},
{
"Field": "NSU",
"Label": "DOC",
"Content": "503801"
},
{
"Field": "DATE",
"Label": "DATA",
"Content": "14/05/24"
},
{
"Field": "HOUR",
"Label": "HORA",
"Content": "16:59"
},
{
"Field": "ISSUER_NAME",
"Label": "EMISSOR",
"Content": "CIELO#VISA CREDITO"
},
{
"Field": "CARD_NUMBER",
"Label": "CARTÃO",
"Content": "476173-0010"
},
{
"Field": "BRAND",
"Label": "BANDEIRA",
"Content": "VISA"
},
{
"Field": "TRANSACTION_TYPE",
"Label": "TIPO DE TRANSAÇÃO",
"Content": "VENDA A CREDITO"
},
{
"Field": "AUTHORIZATION_CODE",
"Label": "AUTORIZAÇÃO",
"Content": "350441"
},
{
"Field": "TRANSACTION_MODE",
"Label": "MODO DA TRANSAÇÃO",
"Content": "ONL"
},
{
"Field": "INPUT_METHOD",
"Label": "MODO DE ENTRADA",
"Content": "X"
},
{
"Field": "CPF_CNPJ",
"Label": "CPF OU CNPJ",
"Content": "73096766000195"
},
{
"Field": "VALUE",
"Label": "VALOR",
"Content": "4,00"
},
{
"Field": "SOFT_DESCRIPTOR",
"Label": "SOFT DESCRIPTOR",
"Content": "Teste API"
}
],
"Receipt": {
"MerchantName": "Loja Teste",
"MerchantAddress": "Alameda Xingu, 512",
"MerchantCity": "BARUERI",
"MerchantState": "SP",
"MerchantCode": "0023137868169300",
"Terminal": "41786816",
"Nsu": "503801",
"Date": "14/05/24",
"Hour": "16:59",
"IssuerName": "CIELO#VISA CREDITO",
"CardNumber": "476173-0010",
"Brand": "VISA",
"TransactionType": "VENDA A CREDITO",
"AuthorizationCode": "350441",
"TransactionMode": "ONL",
"InputMethod": "X",
"CpfCnpj": "73096766000195",
"Value": "4,00",
"SoftDescriptor": "Teste API"
},
"AuthorizationCode": "350441",
"ProofOfSale": "503801",
"InitializationVersion": 1715631088777,
"ConfirmationStatus": 0,
"SubordinatedMerchantId": "{{SubordinatedMerchantId}}",
"OfflinePaymentType": "Online",
"MerchantAcquirerId": "0023137868169300",
"TerminalAcquirerId": "41786816"
}
}| Propriedade | Tipo | Tamanho | Obrigatório | Descrição |
|---|---|---|---|---|
| MerchantOrderId | String | 15 | Sim | Número utilizado para identificação da transação e que deve ser gerado pela aplicação integrada com o Conecta. Aceita apenas valores numéricos de 1 a 15 dígitos e não pode ser duplicado. |
| Customer.Name | String | — | — | — |
| Customer.Identity | — | — | — | — |
| Customer.IdentityType | — | — | — | — |
| Customer.Email | — | — | — | — |
| Customer.Birthday | — | — | — | — |
| Address.Street | String | — | — | — |
| Address.Number | String | — | — | — |
| Address.Complement | String | — | — | — |
| Address.ZipCode | String | — | — | — |
| Address.City | String | — | — | — |
| Address.State | String | — | — | — |
| Address.Country | String | — | — | — |
| DeliveryAddress.Street | String | — | — | — |
| DeliveryAddress.Number | String | — | — | — |
| DeliveryAddress.Complement | String | — | — | — |
| DeliveryAddress.ZipCode | String | — | — | — |
| DeliveryAddress.City | String | — | — | — |
| DeliveryAddress.State | String | — | — | — |
| DeliveryAddress.Country | String | — | — | — |
| Payment.Installments | Integer | — | — | Default: 1 / Quantidade de Parcelas: Varia de 2 a 99 para transação de financiamento. Deve ser verificado os atributos maxOfPayments1, maxOfPayments2, maxOfPayments3 e minValOfPayments da tabela productTable. |
| Payment.Interest | String | — | — | Default: ByMerchant Enum: ByMerchant ByIssuer Tipo de Parcelamento: - Se o bit 6 do atributo confParamOp05, presente nas tabelas issuerTable e binTable e bit 6 do atributo confParamOp03 da tabela productTable estiverem todos habilitados indica que o tipo de parcelamento sem juros pode ser efetuado. - Se o bit 7 do atributo confParamOp05, presente nas tabelas issuerTable e binTable e bit 7 do atributo confParamOp03 da tabela productTable estiverem todos habilitados indica que o tipo de parcelamento com juros pode ser efetuado. Sem juros = “ByMerchant”; Com juros = “ByIssuer”. |
| Payment.Capture | Booleano | — | — | Default: false / Booleano que identifica que a autorização deve ser com captura automática. A autorização sem captura automática é conhecida também como pré-autorização. |
| Payment.CreditCard.EncryptedCardData.EncryptionType | String | — | Sim | Tipo de encriptação utilizada Enum: “DukptDes” = 1, “MasterKey” = 2 “Dukpt3Des” = 3, “Dukpt3DesCBC = 4 |
| Payment.CreditCard.EncryptedCardData.CardNumberKSN | String | — | Sim | Identificador KSN da criptografia do número do cartão |
| Payment.CreditCard.EncryptedCardData.IsDataInTLVFormat | Bool | — | Não | Identifica se os dados criptografados estão no formato TLV (tag / length / value). |
| Payment.CreditCard.EncryptedCardData.InitializationVector | String | — | Sim | Vetor de inicialização da encriptação |
| CreditCard.ExpirationDate | String | MM/yyyy | Sim | Data de validade do cartão. Dado obtido através do comando PP_GetCard na BC no momento da captura da transação. |
| CreditCard.BrandId | Integer | — | Sim | Identificação da bandeira obtida através do campo BrandId da PRODUCT TABLE. |
| CreditCard.IssuerId | Integer | — | Sim | Código do emissor obtido através do campo IssuerId da BIN TABLE. |
| CreditCard.TruncateCardNumberWhenPrinting | Booleano | — | — | Indica se o número do cartão será truncado no momento da impressão do comprovante. A solução de captura deve tomar essa decisão com base no confParamOp03 presente nas tabelas BIN TABLE, PARAMETER TABLE e ISSUER TABLE. |
| CreditCard.InputMode | String | — | Sim | Enum: Typed MagStripe Emv Identificação do modo de captura do cartão na transação. Essa informação deve ser obtida através do retorno da função PP_GetCard da BC. “00” – Magnético “01” - Moedeiro VISA Cash sobre TIBC v1 “02” - Moedeiro VISA Cash sobre TIBC v3 “03” – EMV com contato “04” - Easy-Entry sobre TIBC v1 “05” - Chip sem contato simulando tarja “06” - EMV sem contato. |
| CreditCard.AuthenticationMethod | String | — | Sim | Enum: NoPassword OnlineAuthentication OfflineAuthentication Método de autenticação - Se o cartão foi lido a partir da digitação verificar o bit 3 do atributo confParamOp04 das tabelas binTable, parameterTable e issuerTable. Se todos estiverem habilitados, a senha deve ser capturada e o authenticationMethod assume valor 2. Caso contrário, assume valor 1; - Se o cartão foi lido a partir da trilha verificar o bit 3 do atributo confParamOp04 das tabelas binTable, parameterTable e issuerTable. Se todos estiverem habilitados, deve ser verificado o bit 2 do mesmo campo. Se este estiver com valor 1 deve ser capturada a senha. Se estiver com valor 0 a captura da senha vai depender do último dígito do service code; - Se o cartão foi lido através do chip EMV, o authenticationMethod será preenchido com base no retorno da função PP_GoOnChip(). No resultado PP_GoOnChip(), onde se o campo da posição 003 do retorno da PP_GoOnChip() estiver com valor 1 indica que o pin foi validado off-line, o authenticationMethod será 3. Se o campo da posição 003 e o campo da posição 006 do retorno da PP_GoOnChip() estiverem com valor 0, o authenticationMethod será 1. Se o campo da posição 003 e o campo da posição 006 do retorno da PP_GoOnChip() estiverem com valores 0 e 1 respectivamente, o authenticationMethod será 2. 1 - Sem senha = “NoPassword”; 2 - Senha online = “Online Authentication”; 3 - Senha off-line = “Offline Authentication”. |
| CreditCard.EmvData | String | — | — | Dados da transação EMV Obtidos através do comando PP_GoOnChip na BC |
| PinBlock.EncryptedPinBlock | — | — | — | — |
| PinBlock.EncryptionType | String | — | — | — |
| PinBlock.KsnIdentification | String | — | — | — |
| CreditCard.PanSequenceNumber | Number | — | — | Número sequencial do cartão, utilizado para identificar a conta corrente do cartão adicional. Mandatório para transações com cartões Chip EMV e que possuam PAN Sequence Number (Tag 5F34). |
| CreditCard.SaveCard | — | — | — | — |
| CreditCard.IsFallback | — | — | — | — |
| Payment.PaymentDateTime | String | date-time | Sim | Data e Hora da captura da transação |
| Payment.ServiceTaxAmount | — | — | — | — |
| Payment.SoftDescriptor | String | 13 | — | Identificação do estabelecimento (nome reduzido) a ser impresso e identificado na fatura. |
| Payment.ProductId | Integer | — | Sim | Código do produto identificado através do bin do cartão. |
| PinPadInformation.TerminalId | String | — | Sim | Número Lógico definido no Concentrador Cielo. |
| PinPadInformation.SerialNumber | String | 20 | Sim | Número de Série do Equipamento. |
| PinPadInformation.PhysicalCharacteristics | String | — | Sim | Enum: WithoutPinPad PinPadWithoutChipReader PinPadWithChipReaderWithoutSamModule PinPadWithChipReaderWithSamModule NotCertifiedPinPad PinPadWithChipReaderWithoutSamAndContactless PinPadWithChipReaderWithSamModuleAndContactless Sem PIN-pad = WithoutPinPad; PIN-pad sem leitor de Chip = PinpadWithoutChipReader; PIN-pad com leitor de Chip sem módulo SAM = PinPadWithChipReaderWithoutSamModule; PIN-pad com leitor de Chip com módulo SAM = PinPadWithChipReaderWithSamModule; PIN-pad não homologado = NotCertifiedPinPad; PIN-pad com leitor de Chip sem SAM e Cartão Sem Contato = PinpadWithChipReaderWithoutSamAndContactless; PIN-pad com leitor de Chip com SAM e Cartão Sem Contato = PinpadWithChipReaderWithSamAndContactless. Obs. Caso a aplicação não consiga informar os dados acima, deve obter tais informações através do retorno da função PP_GetInfo() da BC. |
| PinPadInformation.ReturnDataInfo | String | — | Sim | Retorno da função PP_GetInfo() da biblioteca compartilhada |
| Payment.Amount | Integer(int64) | — | Sim | Valor da transação (1079 = R$10,79) |
| Payment.ReceivedDate | — | — | — | — |
| Payment.CapturedAmount | — | — | — | — |
| Payment.Provider | String | — | — | — |
| Payment.ConfirmationStatus | — | — | — | — |
| Payment.InitializationVersion | — | — | — | — |
| Payment.EmvResponseData | — | — | — | — |
| Payment.Status | — | — | — | — |
| Payment.PhysicalTransactionStatus | Integer | 2 | Não | 0 = Não Finalizado → EM ANDAMENTO 2 = Pago → PENDENTE/APROVADA 3 = Negado → NEGADA 10 = Cancelado → CANCELADA 13 = Abortado → DESFEITA 20 = Confirmada → CONFIRMADA |
| Payment.IsSplitted | Booleano | — | — | — |
| Payment.ReturnCode | — | — | — | — |
| Payment.ReturnMessage | String | — | — | — |
| Payment.PaymentId | — | — | — | — |
| Payment.Type | String | — | Sim | Value: PhysicalCreditCard / Tipo da Transação |
| Payment.Currency | String | — | — | Default: “BRL” / Value: “BRL” / Moeda (Preencher com “BRL”) |
| Payment.Country | String | — | — | Default: “BRA” / Value: “BRA” / País (Preencher com “BRA”) |
| Payment.Receipt.MerchantName | String | 255 | Sim | Nome da loja |
| Payment.Receipt.MerchantAddress | String | 255 | Sim | Endereço da loja |
| Payment.Receipt.MerchantCity | String | 255 | Sim | Cidade da loja |
| Payment.Receipt.MerchantState | String | 2 | Sim | Estado da loja |
| Payment.Receipt.MerchantCode | String | 16 | Sim | Codigo de identificação da loja |
| Payment.Receipt.Terminal | String | 8 | Sim | Identificação do Terminal |
| Payment.Receipt.Nsu | String | 6 | Sim | Numero de identificação da transação Cielo |
| Payment.Receipt.Date | String | dd/MM/yy | Sim | Data da transação |
| Payment.Receipt.Hour | String | HH:mm | Sim | Horario da transação |
| Payment.Receipt.IssuerName | String | 255 | Sim | Nome do emissor obtido através do campo IssuerId no objeto BinEntry. |
| Payment.Receipt.CardHolder | String | 255 | Não | Nome do titular do cartão. |
| Payment.Receipt.CardNumber | String | 19 | Sim | Número do cartão |
| Payment.Receipt.Brand | String | 255 | Sim | Bandeira do cartão |
| Payment.Receipt.TransactionType | String | 255 | Sim | Tipo de transação |
| Payment.Receipt.AuthorizationCode | String | 6 | Sim | Código da autorização |
| Payment.Receipt.TransactionMode | String | 3 | Sim | Modo da transação |
| Payment.Receipt.InputMethod | String | 1 | Sim | Metodo de entrada |
| Payment.Receipt.Value | String | 15 | Sim | Valor do pagamento |
| Payment.Receipt.SoftDescriptor | String | 13 | Não | Identificação do estabelecimento (nome reduzido) a ser impresso e identificado na fatura. |
| RecurrentPayment.RecurrentPaymentId | — | — | — | — |
| RecurrentPayment.ReasonCode | — | — | — | — |
| RecurrentPayment.ReasonMessage | — | — | — | — |
| RecurrentPayment.NextRecurrency | — | — | — | — |
| RecurrentPayment.EndDate | — | — | — | — |
| RecurrentPayment.Interval | — | — | — | — |
| SplitPayments.SubordinateMerchantId | — | — | — | — |
| SplitPayments.Amount | — | — | — | — |
| SplitPayments.Fares.Mdr | — | — | — | — |
| SplitPayments.Fares.Fee | — | — | — | — |
| SplitErrors.Code | — | — | — | — |
| SplitErrors.Message | — | — | — | — |