Revise nossas referências de API para implementar o padrão nexo. Para obter uma lista definitiva de especificações para o protocolo nexo, consulte o site de padrões nexo .
Referências da API de terminais
AbortRequest
Definição: Corpo da mensagem de solicitação de cancelamento.
Uso: Transmite as informações solicitadas para identificação da solicitação de mensagem que leva a transação a ser abortada. Uma mensagem a ser exibida no dispositivo CustomerError pode ser enviada pelo sistema de vendas (DisplayOutput).
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Identificação de uma transação POI anterior. |
|
|
AbortReason |
|
String |
Motivo de abortar uma transação. |
|
|
Estrutura de dados definida |
Informações a serem exibidas e a maneira de processar a exibição. |
Para exibir uma mensagem de cancelamento ao cliente. |
AccountType
Nome: AccountType
Tipo: Enumeração
- Default
- Savings
- Checking
- CreditCard
- Universal
- Investment
- CardTotals
- EpurseCard
Alignment
Nome: Alignment
Tipo: Enumeração
- Left
- Right
- Centred
- Justified
AllowedProduct
Definição: Códigos de produtos que são pagáveis pelo cartão de pagamento.
Uso: Produto que pode ser pago pelo cartão de pagamento.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
ProductCode |
|
DigitString |
Código do produto do item adquirido com a transação. |
O comprimento da string deve ser maior ou igual a 1 e menor ou igual a 20 |
EanUpc |
|
DigitString |
Código padrão do produto do item adquirido com a transação. |
|
ProductLabel |
|
String |
Nome do produto de um item comprado com a transação. |
|
AdditionalProductInfo |
|
String |
Informações adicionais relacionadas ao item de linha. |
|
AmountsReq
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
Currency |
|
ISOCurrency |
Moeda para um valor monetário. |
|
RequestedAmount |
|
SimpleAmount |
Valor solicitado pela venda para o pagamento. |
|
CashBackAmount |
|
SimpleAmount |
A parte de cash-back do valor solicitado pela venda para o pagamento. |
|
TipAmount |
|
SimpleAmount |
Valor pago para uma gorjeta. Permite a impressão da gorjeta no recibo e qualifica a parte da quantia do valor. |
|
PaidAmount |
|
SimpleAmount |
Montante já pago em caso de pagamento parcelado. Dependendo do contexto, um pagamento parcelado é um valor parcelado ou uma cesta dividida (exigida por alguns meios de pagamento como cartões de frota). O PaidAmount está presente quando o pagamento dividido é uma divisão do valor. A divisão da cesta envolve duas transações de venda e não deve ser reconhecida pelo POI. |
|
MinimumAmountToDeliver |
|
SimpleAmount |
Valor mínimo que o Sistema de vendas pode entregar para este pagamento. Para o OneTimeReservation, quando o valor máximo é desconhecido, o Sistema de vendas indica o valor mínimo permitido. |
|
MaximumCashBackAmount |
|
SimpleAmount |
Valor máximo que pode ser solicitado para devolução do dinheiro ao Sistema de Vendas. Permite que o Caixa limite o valor do cash-back a entregar ao cliente. |
|
MinimumSplitAmount |
|
SimpleAmount |
Quantidade mínima de uma divisão, que pode ser solicitada por um cliente. Permite que o comerciante limite o número de parcelas solicitada pelo cliente. |
|
AmountsResp
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
Currency |
|
ISOCurrency |
Moeda do valor monetário. |
|
AuthorizedAmount |
|
SimpleAmount |
Valor solicitado pela venda para o pagamento. |
|
TotalRebatesAmount |
|
SimpleAmount |
Soma dos descontos no valor (valor total ou valor do item de linha) para todos os programas de fidelidade. |
|
TotalFeesAmount |
|
SimpleAmount |
Valor total de taxas financeiras. |
|
CashBackAmount |
|
SimpleAmount |
A parte do cash-back do valor solicitado pela venda para o pagamento. |
|
TipAmount |
|
SimpleAmount |
Quantia paga para uma gorjeta. Permita a impressão da gorjeta no recibo e qualifique a parte da gorjeta no valor. |
|
AreaSize
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
X |
|
HexString |
A abscissa de as coordenadas de um ponto. O valor hexadecimal no texto da abcissa das coordenadas de um ponto. O zero inicial pode ser removido (por exemplo, 3BC, 0 e 1287). |
O comprimento da string deve ser maior ou igual a 1 e menor ou igual a 4 |
Y |
|
HexString |
Ordenada de coordenadas de um ponto. O valor hexadecimal no texto da ordenada das coordenadas de um ponto. O zero inicial pode ser removido (por exemplo, 3BC, 0 e 1287). |
O comprimento da string deve ser maior ou igual a 1 e menor ou igual a 4 |
AuthenticationMethod
Nome: AuthenticationMethod
Tipo: Cluster
- Bypass
- ManualVerification
- MerchantAuthentication
- OfflinePIN
- OnlinePIN
- PaperSignature
- SecuredChannel
- SecureCertificate
- SecureNoCertificate
- SignatureCapture
- UnknownMethod
BalanceInquiryRequest
Definição: Conteúdo da mensagem de solicitação de consulta de saldo.
Uso: Transmite informações relacionadas à conta para a qual uma consulta de saldo é solicitada.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Dados relacionados à conta apontada pelo cartão de pagamento. |
|
|
|
Estrutura de dados definida |
Dados relacionados a um programa ou conta de fidelidade solicitado. |
|
BalanceInquiryResponse
Definição: Conteúdo da mensagem de resposta de consulta de saldo.
Uso: Transmite o saldo e a identificação das contas de pagamento, fidelidade ou de valor armazenado.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descreição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Resultado de um processamento de solicitação de mensagem. |
|
|
|
Estrutura de dados definida |
Dados relacionados ao resultado de uma solicitação de consulta de saldo. |
Se BalanceInquiryRequest. PaymentAccount presente. |
|
|
Estrutura de dados definida |
Dados relacionados ao resultado de uma consulta de saldo da conta de fidelidade. |
Se BalanceInquiryRequest. LoyaltyData presente. |
|
|
Estrutura de dados definida |
|
|
BarcodeType
Nome: BarcodeType
Tipo: Enumeração
- EAN8
- EAN13
- UPCA
- Code25
- Code128
- PDF417
- QRCode
CapturedSignature
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Tamanho de uma área. Contem o tamanho da área do bloco onde a assinatura é gravada, fornecida com os valores máximos de abscissa e ordenada (X e Y). O valor máximo é 'FFFF'. |
|
|
|
Estrutura de dados definida |
Coordenadas de um ponto em que a pen muda de direção ou de elevação. Contem as coordenadas de um ponto da assinatura escrita em que a pen muda de direção ou levanta onte (X e Y). Quando o assinante levanta a pen, X e Y têm o valor 'FFFF'. |
|
CardAcquisitionRequest
Definição: Conteúdo da mensagem de solicitação de aquisição de cartão.
Uso: Transmite informações relacionadas aos cartões de pagamento e fidelidade para leitura e análise. Esse par de mensagens geralmente é seguido por um par de mensagens (por exemplo, pagamento ou lealdade) que se refere a esse par de mensagens de Aquisição de cartão.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Dados relacionados ao sistema de vendas. |
|
|
|
Estrutura de dados definida |
Dados relacionados à aquisição e pagamento com cartão de fidelidade. |
|
CardAcquisitionResponse
Definição: Conteúdo da mensagem de resposta de aquisição do cartão.
Uso: Transmite informações relacionadas aos cartões de pagamento e de fidelidade lidos e processados pelo sistema POI e inseridos pelo cliente.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Resultado de um processamento de solicitação de mensagem. |
|
|
|
Estrutura de dados definida |
Dados relacionados ao sistema de vendas. |
|
|
|
Estrutura de dados definida |
Dados relacionados ao sistema POI. |
|
|
CustomerLanguage |
|
ISOLanguage |
Dados relacionados ao sistema POI. |
|
PaymentBrand |
|
String |
Tipo de cartão de pagamento. |
Marcas disponíveis para pagamento com cartão e não escolhidas pelo cliente.. |
|
Estrutura de dados definida |
Dados relacionados ao instrumento de pagamento da transação. |
Se este tipo de cartão de pagamento estiver configurado para enviar informações se a resposta do CardAcquisition. |
CardAcquisitionTransaction
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
AllowedPaymentBrand |
|
String |
|
|
AllowedLoyaltyBrand |
|
String |
|
|
|
Enumeration |
|
|
|
CustomerLanguage |
|
ISOLanguage |
|
|
|
Cluster |
|
|
|
ForceCustomerSelectionFlag |
|
Boolean |
|
|
TotalAmount |
|
SimpleAmount |
|
|
|
Enumeration |
|
|
|
CashBackFlag |
|
Boolean |
|
|
CardData
Definição: Informações relacionadas ao cartão de pagamento usado para a transação.
Uso: Permite a aquisição dos dados do cartão pelo sistema de vendas antes da solicitação de pagamento, aquisição de cartão ou BalanceInquiry ao POI. Também pode ser enviado na resposta CardAcquisition, para ser processado pelo sistema de vendas.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
PaymentBrand |
|
String |
Tipo de cartão de pagamento. |
Se o PAN do cartão estiver legível. |
MaskedPan |
|
String |
|
|
PaymentAccountRef |
|
String |
|
|
|
Cluster |
Modo de entrada das informações do instrumento de pagamento. |
Obrigatório na solicitação. |
|
CardCountryCode |
|
DigitString |
Código do país anexado ao cartão (3 numéricos). |
Se disponível no cartão. O comprimento da string deve ser exatamente 3 |
ProtectedCardData |
|
ContentInformation |
Informações sensíveis relacionadas ao cartão de pagamento, protegidas pelo CMS. |
SensitiveCardData protegido pelo CMS EnvelopedData. |
|
Estrutura de dados definida |
Informações sensíveis relacionadas ao cartão de pagamento, inseridas ou lidas pelo sistema de vendas. |
Se a estrutura não estiver vazia e desprotegida. |
|
AllowedProductCode |
|
DigitString |
Códigos do produto que são pagáveis pelo cartão de pagamento. |
Caso contrário, nem todos os produtos serão aceitos para o cartão de pagamento proposto pelo cliente. Nesse caso, o resultado é falha, ErrorCondition é Payment Restriction. Para One Time Reservation, o POI pode enviar códigos de produtos pagáveis pelo meio pagamento, mesmo que o POI não tenha enviado o SaleItem na solicitação. Se pelo menos um produto enviado na solicitação for aceito, o resultado é sucesso. O comprimento da string deve ser maior ou igual a 1 e menor ou igual a 20 |
|
Estrutura de dados definida |
Produto pagável pelo cartão de pagamento. |
|
|
|
Estrutura de dados definida |
Substituto do PAN (Primary Account Number) do cartão de pagamento para identificar o meio de pagamento do cliente. Permite, para um comerciante, identificar o cliente. |
Restrição do produto pagável por um cartão. |
|
|
Estrutura de dados definida |
Pedido do cliente anexado a um cliente, registrado no sistema POI. Permite o gerenciamento de pedidos de clientes pelo POI, por exemplo, em uma transação de venda multicanal ou click and collect. |
|
CardReaderAPDUResponse
Definição: Conteúdo da mensagem de resposta do APDU do leitor de cartão..
Uso: Contém o resultado do serviço solicitado, resposta APDU enviada pelo chip do cartão em resposta à solicitação APDU.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Resultado de um processamento de solicitação de mensagem. |
|
|
APDUData |
|
ByteSequence |
Campo de dados do comando APDU (Lc + Data). |
|
CardStatusWords |
|
ByteSequence |
Status de uma resposta de um smartcard response a um comando (SW1-SW2). |
O comprimento da bytesequence deve se exatamente 2 |
CashHandlingDevice
Definição: Status do dispositivo de manuseio de dinheiro.
Uso: Indique o status e as moedas e faturas restantes em um dispositivo de manuseio de dinheiro.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
CashHandlingOKFlag |
|
Boolean |
Indica se o dispositivo de manuseio de dinheiro está funcionando e é utilizável. |
|
Currency |
|
ISOCurrency |
Moeda de um valor monetário. |
|
|
Estrutura de dados definida |
Número de moedas ou notas de um determinado valor. |
|
CharacterHeight
Nome: CharacterHeight
Tipo: Enumeração
- SingleHeight
- DoubleHeight
- HalfHeight
CharacterStyle
Nome: CharacterStyle
Tipo: Enumeração
- Normal
- Bold
- Italic
- Underline
CharacterWidth
Nome: CharacterWidth
Tipo: Enumeração
- SingleWidth
- DoubleWidth
CheckData
Definição: Informações relacionadas a um cheque utilizado para a transação.
Uso: Permite que as informações do cheque sejam fornecidas pelo sistema de vendas antes de solicitar o pagamento ou armazenadas pelo sistema de vendas após o processamento do pagamento.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
BankID |
|
String |
Identificação do banco. |
Obrigatório se TrackData estiver ausente. |
AccountNumber |
|
String |
Identificação da conta do cliente. |
Obrigatório se TrackData estiver ausente. |
CheckNumber |
|
String |
Identificação do cheque bancário. |
Obrigatório se TrackData estiver ausente. |
|
Estrutura de dados definida |
Faixa magnética linha de caracteres com tinta magnética. |
Obrigatório se o CheckNumber estiver ausente. |
|
CheckCardNumber |
|
String |
Número do cartão de garantia do cheque. |
Se fornecido pelo cliente. |
|
Enumeration |
Tipo de cheque bancário. |
|
|
Country |
|
ISOCountry |
País do cheque bancário. |
Ausente se o país do sistema de venda. |
CoinsOrBills
Definição: Número de moedas ou notas de um determinado valor.
Uso: Indica o número restante de moedas ou notas de um determinado valor em um dispositivo de manuseio de dinheiro. Quando a máquina que liga com o dinheiro não possui mais moedas ou notas de um determinado valor, o número deve ser igual a 0.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
UnitValue |
|
SimpleAmount |
Valor de uma moeda ou nota. |
|
Number |
|
Integer |
Número de elementos |
|
Color
Nome: Color
Tipo: Enumeração
- White
- Black
- Red
- Green
- Blue
- Yellow
- Magenta
- Cyan
ConvertedAmount
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
AmountValue |
|
SimpleAmount |
Valor da quantia. |
|
Currency |
|
ISOCurrency |
Moeda de um valor monetário. |
|
CurrencyConversion
Definição: Informações relacionadas a uma conversão de moeda.
Uso: : Ocorreu uma conversão de moeda no pagamento e o comerciante precisa conhecer as informações relacionadas a essa conversão (por exemplo, para imprimir no recibo da venda).
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
CustomerApprovedFlag |
|
Boolean |
Notifique se o cliente aprovou algo. Indica se o cliente aceitou uma conversão de moeda. |
|
|
Estrutura de dados definida |
Valor após uma conversão de moeda. |
|
|
Rate |
|
Decimal |
Taxa de conversão de moeda. |
|
Markup |
|
Decimal |
Markup de um valor de conversão de moeda como uma porcentagem.. |
|
Commission |
|
SimpleAmount |
Comissão para uma conversão de moeda. |
|
Declaration |
|
String |
Declaração a apresentar ao cliente ou ao caixa para validação. |
Se uma declaração tiver que ser apresentada ao cliente. |
CustomerOrder
Definição: Pedido anexado a um cliente, registrado no sistema POI.
Uso: Permite o gerenciamento de pedidos de clientes pelo POI, por exemplo, em uma
transação de venda multicanal ou click and collect.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
CustomerOrderID |
|
String |
Identificação adicional e opcional de um pedido do cliente. |
|
SaleReferenceID |
|
String |
Identificação de uma transação global de venda para uma sequência de transações de POI relacionadas. Identificação de uma transação de reserva para a sequência da reserva e a conclusão. |
|
OpenOrderState |
|
Boolean |
Especifica se um pedido do cliente está aberto no momento. Um pedido em aberto do cliente é um pedido aguardando operações adicionais. |
|
StartDate |
|
ISODateTime |
Data e hora do início de uma operação. |
|
EndDate |
|
ISODateTime |
Data e hora do final de uma operação. |
|
ForecastedAmount |
|
SimpleAmount |
Dependendo da escolha do sistema de venda, ele pode ser igual ao valor inicial do pedido ou ao valor global do pedido. Se ForecastedAmount for igual ao valor inicial do pedido, permitirá que o sistema siga qualquer pagamento adicional. Em caso de igualdade com o valor global do pedido, o sistema poderá acompanhar os valores restantes. |
|
CurrentAmount |
|
SimpleAmount |
Valor total de todas as transações concluídas de um pedido do cliente. |
|
Currency |
|
ISOCurrency |
Moeda de um valor monetário. |
|
AccessedBy |
|
String |
Identificação de uma entidade que acessa dados para executar uma operação. Permitir a sincronização do processamento de pedidos do cliente, quando várias partes do sistema de vendas acessam um pedido do cliente ao mesmo tempo. A entidade de venda ativa no pedido do cliente é identificada por esses dados |
|
AdditionalInformation |
|
String |
Informação não qualificada. |
|
CustomerOrderReq
Nome: CustomerOrderReq
Tipo: Cluster
- Open
- Closed
- Both
Device
Nome: Device
Tipo: Enumeração
- CashierDisplay
- CustomerDisplay
- CashierInput
- CustomerInput
DiagnosisRequest
Definição: Conteúdo da mensagem de solicitação de diagnóstico.
Uso: Transmite informações relacionadas ao POI de destino para o qual o diagnóstico é solicitado.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
POIID |
|
String |
Identificação de um sistema de POI ou de um terminal de POI para o protocolo de venda para POI. |
MessageHeader.POIID. |
HostDiagnosisFlag |
|
Boolean |
Indica se o diagnóstico do host é necessário. |
|
AcquirerID |
|
DigitString |
Identificação do Adquirente. |
Presente se estiver solicitando apenas o diagnóstico desses hosts. |
DiagnosisResponse
Definição: Conteúdo da mensagem de resposta ao diagnóstico.
Uso: Transmite o resultado do diagnóstico solicitado e uma possível mensagem a ser exibida em um dispositivo lógico.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Resultado de um processamento de solicitação de mensagem. |
|
|
LoggedSaleID |
|
String |
Terminal de venda conectado. |
Se o terminal de vendas conectou-se à este Terminal POI. |
|
Estrutura de dados definida |
Estado de um terminal de POI. |
Se Response.Result é Success. |
|
|
Estrutura de dados definida |
Estado de um host. |
|
DisplayOutput
Definição: Informações a serem exibidas e a maneira de processar a exibição.
Uso: Este contém uma operação de exibição completa para um tipo de monitor ou dispositivo de entrada. Para os dispositivos de entrada, Diagnóstico e EnableService, ResponseRequiredFlag e MinimumDisplayTime devem estar ausentes.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
ResponseRequiredFlag |
|
Boolean |
Pedido de uma resposta da mensagem. |
|
MinimumDisplayTime |
|
Integer |
Número de segundos em que a mensagem deve ser exibida. |
|
|
Enumeration |
Dispositivo lógico localizado em um terminal de vendas ou em um terminal de POI, em termos de classe de informações a serem exibidas (exibição, impressão ou armazenamento) ou entrada (teclado) do caixa ou do cliente. |
CashierDisplay, CustomerDisplay. |
|
|
Enumeration |
Qualificação das informações a serem enviadas para um dispositivo lógico de saída, para exibição ou impressão no caixa ou para o cliente. |
Status, Error, Display, POIReplication. |
|
|
Estrutura de dados definida |
Conteúdo a ser exibido ou impresso. |
|
|
|
Estrutura de dados definida |
|
|
|
OutputSignature |
|
ByteSequence |
Assinatura específica do fornecedor da mensagem de texto a ser exibida ou impressa. |
Se for necessário fornecer proteção ao fornecedor no texto a ser exibido ou impresso. |
DisplayRequest
Definição: Conteúdo da mensagem de solicitação de exibição.
Uso: Transmite os dados a serem exibidos e a maneira de processar a exibição. Ele contém o conteúdo completo a ser exibido. Pode conter uma operação (o elemento DisplayOutput) por tipo de dispositivo de exibição.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Informações a serem exibidas e a maneira de processar a exibição. |
Conteúdo de exibição completo para dispositivos de saída. No máximo, um par DisplayOutput por dispositivo / InfoQualify. |
DisplayResponse
Definição: Conteúdo da mensagem de resposta de exibição.
Uso: Transmite o resultado da exibição, paralelo à solicitação de mensagem, exceto se a resposta não for necessária e ausente.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Informações relacionadas ao resultado de output (display, print, input). |
Um por item da DisplayOutput de solicitação, e na mesma ordem. |
DocumentQualifier
Nome: DocumentQualifier
Tipo: Enumeração
- SaleReceipt
- CashierReceipt
- CustomerReceipt
- Document
- Voucher
- Journal
EnableServiceRequest
Definição: Conteúdo da mensagem Enable Service Request.
Uso: Transmite os serviços que serão habilitados para o Terminal de POI sem a solicitação do sistema de vendas, e um possível convite para o cliente iniciar os serviços.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
Ação a ser realizada em uma transação. |
|
|
|
Cluster |
Serviços que são ativados antes da inicialização de uma transação. |
Obrigatório se TransactionAction for 'StartTransaction',caso contrário, será ausente. |
|
|
Estrutura de dados definida |
Informações a serem exibidas e a maneira de processar a exibição. |
|
EnableServiceResponse
Definição: Conteúdo da mensagem Enable Service Response.
Uso: transmite o resultado do processamento do processamento de Enable Service.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Resultado de um processamento de solicitação de mensagem. |
|
EntryMode
Nome: EntryMode
Tipo: Cluster
- RFID
- Keyed
- Manual
- File
- Scanned
- MagStripe
- ICC
- SynchronousICC
- Tapped
- Contactless
- Mobile
ErrorCondition
Nome: ErrorCondition
Tipo: Enumeração
- Aborted
- Busy
- Cancel
- Communication timeout
- DeviceOut
- InsertedCard
- InProgress
- LoggedOut
- MessageFormat
- NotAllowed
- NotFound
- PaymentRestriction
- Refusal
- UnavailableDevice
- UnavailableService
- InvalidCard
- UnreachableHost
- WrongPIN
EventNotification
Definição: Conteúdo da mensagem EventNotification.
Uso: Transmite informações relacionadas ao evento e possíveis ações (manutenção, mensagem a ser exibida).
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
TimeStamp |
|
ISODateTime |
Data e hora de uma transação para o sistema de vendas, o sistema de POI ou o adquirente. |
|
|
Enumeration |
Evento que o POI notifica ao sistema de venda. |
|
|
EventDetails |
|
String |
Informações sobre o evento que o POI notifica ao sistema de venda. |
Se presente, a venda registra-o para exame mais aprofundado. |
RejectedMessage |
|
ByteSequence |
Pedido de mensagem rejeitado pelo destinatário. |
Obrigatório se EventToNotify for 'Reject', ausente em outros casos. |
MaintenanceRequiredFlag |
|
Boolean |
Indica se o evento ocorrido requer uma chamada ou ação de manutenção. |
|
CustomerLanguage |
|
ISOLanguage |
Idioma do cliente. |
Se o idioma for selecionado pelo sistema de vendas antes da solicitação ao POI. |
|
Estrutura de dados definida |
Informações a serem exibidas e a maneira de processar a exibição. |
Para exibir uma mensagem de evento. |
EventToNotify
Nome: EventToNotify
Tipo: Enumeração
- BeginMaintenance
- EndMaintenance
- Shutdown
- Initialised
- OutOfOrder
- Completed
- Abort
- SaleWakeUp
- SaleAdmin
- CustomerLanguage
- KeyPressed
- SecurityAlarm
- StopAssistance
- CardInserted
- CardRemoved
- Reject
ForceEntryMode
Nome: ForceEntryMode
Tipo: Cluster
- RFID
- Keyed
- Manual
- File
- Scanned
- MagStripe
- ICC
- SynchronousICC
- Tapped
- Contactless
- CheckReader
GenericProfile
Nome: GenericProfile
Tipo: Enumeração
- Basic
- Standard
- Extended
GeographicCoordinates
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
Latitude |
|
String |
|
|
Longitude |
|
String |
|
|
Geolocation
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
|
|
|
|
Estrutura de dados definida |
|
|
GetTotalsRequest
Definição: Conteúdo da mensagem Get Totals Request.
Uso: Transmite informações do sistema de vendas relacionadas ao escopo e ao formato dos totals a serem calculados pelo Sistema de POI.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Cluster |
Indica a estrutura hierárquica do resultado da reconciliação da reconciliação venda para POI. |
Exigir a apresentação de totals por valor do elemento incluído neste cluster (POI Terminal, Sale Terminal, Cashier, Shift, TotalsGroupID). |
|
|
Estrutura de dados definida |
Filtro para calcular os totals |
Se a estrutura não estiver vazia. |
GetTotalsResponse
Definição: Conteúdo da mensagem de resposta de reconciliação.
Uso: Transmite informações relacionadas à transação de reconciliação processada pelo sistema POI.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Resultado de um processamento de solicitação de mensagem. |
|
|
POIReconciliationID |
|
DigitString |
Identificação do período de reconciliação entre venda e POI. |
|
|
Estrutura de dados definida |
Resultado do processo de reconciliação de venda para POI. |
Se Response.Result for Success. |
GlobalStatus
Nome: GlobalStatus
Tipo: Enumeração
- OK
- Busy
- Maintenance
- Unreachable
HostStatus
Definição: Estado de um host.
Uso: Indique a acessibilidade do host pelo Terminal POI.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
AcquirerID |
|
Estrutura de dados definida |
Identificação do Adquirente. |
|
IsReachableFlag |
|
Boolean |
Indique se um host está acessível. |
|
IdentificationSupport
Nome: IdentificationSupport
Tipo: Enumeração
- NoCard
- LoyaltyCard
- HybridCard
- LinkedCard
IdentificationType
Nome: IdentificationType
Tipo: Enumeração
- PAN
- ISOTrack2
- BarCode
- AccountNumber
- PhoneNumber
InfoQualify
Nome: InfoQualify
Tipo: Enumeração
- Status
- Error
- Display
- Sound
- Input
- POIReplication
- CustomerAssistance
- Receipt
- Document
- Voucher
Input
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
|
|
|
ConfirmedFlag |
|
Boolean |
|
|
FunctionKey |
|
DigitString |
|
|
TextInput |
|
Unicode String |
|
|
DigitInput |
|
DigitString |
|
|
Password |
|
ContentInformation |
|
|
MenuEntryNumber |
|
Integer |
|
|
InputCommand
Nome: InputCommand
Tipo: Enumeração
- GetAnyKey
- GetConfirmation
- SiteManager
- TextString
- DigitString
- DecimalString
- GetFunctionKey
- GetMenuEntry
- Password
InputData
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
|
|
|
|
Enumeration |
|
|
|
|
Enumeration |
|
|
|
NotifyCardInputFlag |
|
Boolean |
|
|
MaxInputTime |
|
Integer |
|
|
ImmediateResponseFlag |
|
Boolean |
|
|
MinLength |
|
Integer |
|
|
MaxLength |
|
Integer |
|
|
MaxDecimalLength |
|
Integer |
|
|
WaitUserValidationFlag |
|
Boolean |
|
|
DefaultInputString |
|
String |
|
|
StringMask |
|
String |
|
|
FromRightToLeftFlag |
|
Boolean |
|
|
MaskCharactersFlag |
|
Boolean |
|
|
BeepKeyFlag |
|
Boolean |
|
|
GlobalCorrectionFlag |
|
Boolean |
|
|
DisableCancelFlag |
|
Boolean |
|
|
DisableCorrectFlag |
|
Boolean |
|
|
DisableValidFlag |
|
Boolean |
|
|
MenuBackFlag |
|
Boolean |
|
|
InputRequest
Definição: Conteúdo da mensagem de Request.
Uso: Este transmite dados para exibição e a maneira de processar a exibição e contém o conteúdo completo a ser exibido. Além da exibição no dispositivo de entrada, ele pode conter uma operação (o elemento DisplayOutput) por tipo de dispositivo de exibição.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrioção | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Informações a serem exibidas e a maneira de processar a exibição. |
|
|
|
Estrutura de dados definida |
Informações relacionadas a uma solicitação de entrada. |
|
InputResponse
Definição: Conteúdo da mensagem de Input Response.
Uso: Transmite o resultado da input ou o resultado das outputs, paralelo à solicitação da mensagem, exceto se a resposta não for necessária e ausente.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrioção | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Informações relacionadas ao resultado da output (exibição, impressão, entrada). |
Se DisplayOutput é presente na solicitação. |
|
|
Estrutura de dados definida |
Informações relacionadas ao resultado da entrada. |
|
InputResult
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrioção | Regra |
---|---|---|---|---|
|
Enumeration |
|
|
|
|
Enumeration |
|
|
|
|
Estrutura de dados definida |
|
|
|
|
Estrutura de dados definida |
|
|
Instalment
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrioção | Regra |
---|---|---|---|---|
|
Enumeration |
|
|
|
SequenceNumber |
|
Integer |
|
|
PlanID |
|
String |
|
|
Period |
|
Integer |
|
|
|
Enumeration |
|
|
|
FirstPaymentDate |
|
ISODate |
|
|
TotalNbOfPayments |
|
Integer |
|
|
CumulativeAmount |
|
SimpleAmount |
|
|
FirstAmount |
|
SimpleAmount |
|
|
Charges |
|
SimpleAmount |
|
|
InstalmentType
Nome: InstalmentType
Tipo: Enumeração
- DeferredInstalment
- EqualInstalments
- UnequalInstalments
LoginRequest
Definição: Conteúdo da mensagem de Solicitação de Login.
Usage: Este transmite as informações relacionadas à sessão (período entre um Login e o Logout a seguir) para processar.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrioção | Regra |
---|---|---|---|---|
DateTime |
|
ISODateTime |
Data e hora. |
|
|
Estrutura de dados definida |
Informações relacionadas ao software do sistema de venda que gerencia o protocolo de venda para POI. |
|
|
|
Estrutura de dados definida |
Informações relacionadas ao recurso de software e hardware do Terminal de vendas. |
Apresente se o logon envolve um terminal de vendas. |
|
TrainingModeFlag |
|
Boolean |
Modo de treinamento. |
O POI não realiza a transação com o Adquirente. |
OperatorLanguage |
|
ISOLanguage |
Idioma do caixa ou operador. |
O valor padrão para o tipo de dispositivo é exibido. |
OperatorID |
|
String |
Identificação do caixa ou operador. |
4 condições para enviá-lo: a) o sistema de vendas deseja que o POI registre-o no log de transações b) devido à reconciliação. |
ShiftNumber |
|
String |
Número do Shift . |
O mesmo que OperatorID. |
|
Enumeration |
um cartão de pagamento para identificar o meio de pagamento do cliente. Ele permite que um comerciante use um token apenas para uma transação ou por um período mais longo. |
|
|
|
Cluster |
Lista de pedidos do cliente abertos, fechados ou ambos a serem enviados nas mensagens de resposta. |
|
|
POISerialNumber |
|
String |
Número de série de um terminal POI. |
Se o login envolver um terminal POI e não o primeiro login no sistema POI. |
LoginResponse
Definição: Conteúdo da mensagem de resposta de login
Uso: Transmite informações relacionadas ao login para processar.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrioção | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Resultado de um processamento de solicitação de mensagem. |
|
|
|
Estrutura de dados definida |
Informações relacionadas ao sistema de POI. |
se Response.Result for Success. |
|
TokenRequestStatus |
|
Boolean |
|
|
CustomerOrderStatus |
|
Boolean |
|
|
LogoutRequest
Definição: Conteúdo da mensagem de Solicitação de Logout.
Uso: Vazio.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrioção | Regra |
---|---|---|---|---|
MaintenanceAllowed |
|
Boolean |
|
|
LogoutResponse
Definição: Conteúdo da mensagem de resposta de logoff.
Uso: Transmite o resultado do Logout.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrioção | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Resultado de um processamento de solicitação de mensagem. |
|
LoyaltyAccount
Definição: Dados relacionados a uma conta de fidelidade processada na transação.
Uso: Essa estrutura de dados transmite a identificação da conta e a marca de fidelidade associada.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrioção | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Identificação de uma conta fidelidade. |
|
|
LoyaltyBrand |
|
String |
Identificação de uma marca fidelidade. |
Se um cartão é analisado. |
LoyaltyAccountID
Definição: Identificação de uma conta fidelidade.
Uso: Na solicitação de mensagem de pagamento ou fidelidade, é possível identificar a conta fidelidade pelo terminal em vez do Terminal de POI (por exemplo, porque a identificação da conta é um código de barras lido pelo Caixa em um dispositivo de scanner).
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Cluster |
|
|
|
|
Enumeration |
|
|
|
|
Enumeration |
|
|
|
LoyaltyID |
|
String |
|
|
LoyaltyAccountReq
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
|
|
|
|
Estrutura de dados definida |
|
|
LoyaltyAccountStatus
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
|
|
|
CurrentBalance |
|
SimpleAmount |
|
|
|
Enumeration |
|
|
|
Currency |
|
ISOCurrency |
|
|
LoyaltyAcquirerData
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
LoyaltyAcquirerID |
|
String |
|
|
ApprovalCode |
|
String |
|
|
|
Estrutura de dados definida |
|
|
|
HostReconciliationID |
|
String |
|
|
LoyaltyAmount
Definition: Valor de fidelidade.
Usage: Um valor concedido ou um valor a ser resgatado na conta fidelidade pode ser enviado na mensagem de solicitação de pagamento.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
|
|
|
Currency |
|
ISOCurrency |
|
|
AmountValue |
|
SimpleAmount |
|
|
LoyaltyData
Definição: Dados relacionados a um programa ou conta fidelidade.
Uso: Na mensagem solicitação de pagamento, fidelidade ou solicitação de saldo, é permitido que o terminal envie a identificação da conta fidelidade, um valor concedido ou um valor a ser resgatado na conta fidelidade.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Referência à última CardAcquisition, para usar o mesmo cartão. |
Se o ID da conta fidelidade vide de uma CardAcquisition anterior. |
|
|
Estrutura de dados definida |
Identificação de uma conta fidelidade. |
Se a identificação fidelidade da conta fidelidade for realizada pelo sistema de vendas. |
|
|
Estrutura de dados definida |
Valor de uma conta fidelidade. |
Quando o sistema de vendas deseja conceder uma conta fidelidade (não é para o BalanceInquiryRequest). |
LoyaltyHandling
Nome: LoyaltyHandling
Tipo: Enumeração
- Forbidden
- Processed
- Allowed
- Proposed
- Required
LoyaltyResponse
Definição: Conteúdo da mensagem de Loyalty Response.
Uso: Transmite informações relacionadas à transação fidelidade processada pelo sistema POI.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Resultado de um processamento de solicitação de mensagem. |
|
|
|
Estrutura de dados definida |
Dados relacionados ao sistema de vendas. |
|
|
|
Estrutura de dados definida |
Dados relacionados ao sistema POI. |
|
|
|
Estrutura de dados definida |
Dados relacionados ao resultado de uma transação de fidelidade processada. |
Se a conta de fidelidade for identificada. |
|
|
Estrutura de dados definida |
|
|
LoyaltyResult
Definição: Dados relacionados ao resultado de uma transação de fidelidade processada.
Uso: Na resposta da mensagem, o resultado de cada transação de marca fidelidade.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Dados relacionados a uma conta fidelidade processada na transação. |
|
|
CurrentBalance |
|
SimpleAmount |
Saldo de uma conta. |
Se conhecido (fornecido pelo cartão ou por um host externo). |
|
Estrutura de dados definida |
Valor de uma conta fidelidade. |
Se o valor for concedido. |
|
|
Estrutura de dados definida |
Dados relacionados ao adquirente da fidelidade durante uma transação de fidelidade. |
Se o conteúdo não estiver vazio. |
|
|
Estrutura de dados definida |
Formulário de abatimento para um prêmio. |
Se o abatimento for concedido. |
LoyaltyTotals
Definição: Totals das transações de fidelidade durante o período de reconciliação.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
Tipo de transação para a qual os totals estão agrupados. |
Award, ReverseAward, Redemption, ReverseRedemption, Rebate, ReverseRebate. |
|
TransactionCount |
|
Integer |
Número de transações processadas durante o período. |
|
TransactionAmount |
|
SimpleAmount |
Soma do valor da transação processada durante o período. |
|
LoyaltyUnit
Nome: LoyaltyUnit
Tipo: Enumeração
- Point
- Monetary
MenuEntry
Definição: Uma entrada do menu para apresentar ao Caixa.
Uso: Transmite o texto da mensagem e os parâmetros da entrada do menu. Esses dados de saída podem ser fornecidos apenas para um comando de entrada, a fim de escolher uma entrada do menu.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
Características relacionadas à seleção de uma entrada do menu. |
|
|
DefaultSelectedFlag |
|
Boolean |
|
|
|
Enumeration |
|
|
|
|
Estrutura de dados definida |
|
|
|
|
Estrutura de dados definida |
|
|
|
OutputXHTML |
|
ByteSequence |
|
|
MenuEntryTag
Nome: MenuEntryTag
Tipo: Enumeração
- Selectable
- NonSelectable
- SubMenu
- NonSelectableSubMenu
MessageCategory
Nome: MessageCategory
Tipo: Enumeração
- Abort
- Admin
- BalanceInquiry
- Batch
- CardAcquisition
- CardReaderAPDU
- CardReaderInit
- CardReaderPowerOff
- Diagnosis
- Display
- EnableService
- Event
- GetTotals
- Input
- InputUpdate
- Login
- Logout
- Loyalty
- Payment
- PIN
- Reconciliation
- Reversal
- Sound
- StoredValue
- TransactionStatus
- Transmit
MessageClass
Nome: MessageClass
Tipo: Enumeração
- Service
- Device
- Event
MessageHeader
Definição: Cabeçalho da mensagem da mensagem do protocolo Sale to POI.
Usage: Transmite informações relacionadas ao gerenciamento do protocolo Sale to POI.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
ProtocolVersion |
|
String |
|
Se MessageCategory for Login ou Diagnosis. |
|
Enumeration |
Classe da mensagem. |
|
|
|
Enumeration |
Categoria da mensagem. |
|
|
|
Enumeration |
Tipo de mensagem do protocolo Sale to POI. |
|
|
ServiceID |
|
String |
Identificação de um par de mensagens, que processa uma transação. |
Necessário se a mensagem MessageClass 'Service' ou 'Event' ou se MessageClass 'Device' e solicitação do POI ou resposta de Sale. O comprimento da string deve ser maior ou igual a 1 e menor ou igual a 10 |
DeviceID |
|
String |
Identificação de um par de mensagens do dispositivo. |
Se MessageClass 'Device'. O comprimento da string deve ser maior ou igual a 1 e menor ou igual a 10 |
SaleID |
|
String |
Identificação de um sistema de venda ou de um terminal de venda para o protocolo Sale to POI. |
|
POIID |
|
String |
Identificação de um sistema de POI ou de um terminal de POI para o protocolo de Sale to POI. |
|
MessageReference
Definição: Identificação de uma transação POI anterior.
Uso: To abort a transaction in progress or to request the status of a transaction from which no response has been received. It identifies the message header of the message request to abort or request the status.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
Categoria da mensagem. |
CardAcquisition, Display, Input, Loyalty, Payment, Print, CardReaderAPDU, CardReaderInit, CardReaderPowerOff. |
|
ServiceID |
|
String |
Identificação de um par de mensagens, que processa uma transação. |
O comprimento da string deve ser maior ou igual a 1 e menor ou igual a 10 |
DeviceID |
|
String |
Identificação de um par de mensagens do dispositivo. |
O comprimento da string deve ser maior ou igual a 1 e menor ou igual a 10 |
SaleID |
|
String |
Identificação de um sistema de venda ou de um terminal para o protocolo Sale to POI. |
default MessageHeader.SaleID. |
POIID |
|
String |
Identificação de um sistema de POI ou de um terminal de POI para o protocolo de Sale to POI. |
default MessageHeader.POIID. |
MessageType
Nome: MessageType
Tipo: Enumeração
- Request
- Response
- Notification
MobileData
Definição: Informações relacionadas ao celular para a transação de pagamento.
Uso: O telefone celular é usado como um instrumento de pagamento para a transação.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
MobileCountryCode |
|
DigitString |
Identifica o país de uma operadora de celular. |
Se houver dados disponíveis. O comprimento da string deve ser exatamente 3 |
MobileNetworkCode |
|
DigitString |
Identifica a operadora de telefonia móvel dentro de um país. |
Se houver dados disponíveis. O comprimento da string deve ser maior ou igual a 2 e menor ou igual a 3 |
MaskedMSISDN |
|
DigitString |
Masked Mobile Subscriber integrado com o Service Digital Network. |
Se houver dados disponíveis. |
|
DEstrutura de dados definida |
Localização geográfica especificada por coordenadas geográficas ou UTM. |
Se houver dados disponíveis. |
|
ProtectedMobileData |
|
ContentInformation |
Informações confidenciais relacionadas ao telefone celular, protegidas pelo CMS. |
SensitiveMobileData. |
|
Estrutura de dados definida |
Informações confidenciais relacionadas ao telefone celular. |
Se dados móveis não protegidos |
OriginalPOITransaction
Definição: Identificação de uma transação POI anterior.
Uso: Na mensagem pagamento ou solicitação de fidelidade, é permitido usar o cartão de uma solicitação CardAcquisition ou Payment/Loyalty anterior.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
SaleID |
|
String |
Identificação de um sistema de venda ou de um terminal de venda para o protocolo Sale to POI. |
|
POIID |
|
String |
Identificação de um sistema de POI ou de um terminal de POI para o protocolo Saelo to POI. |
Se a transação original vier de outro POI. |
|
Estrutura de dados definida |
Identificação exclusiva de uma transação de POI para um POI. |
Ausente se SaleReferenceID for suficiente para identificar a transação. |
|
ReuseCardDataFlag |
|
Boolean |
Indica se os dados do cartão precisam ser obtidos de uma transação anterior. |
|
ApprovalCode |
|
String |
Código atribuído a uma aprovação de transação pelo Adquirente. |
Se referral. |
CustomerLanguage |
|
ISOLanguage |
Idioma do cliente. |
Se o idioma for selecionado pelo sistema de vendas antes da solicitação ao POI. |
AcquirerID |
|
DigitString |
Identificação do Adquirente. |
Restrinja a este Adquirente, se presente. |
AmountValue |
|
SimpleAmount |
|
|
|
Estrutura de dados definida |
Identificação da transação pelo host responsável pela transação de valor armazenado. |
Se POITransactionID não estiver presente. |
OutputBarcode
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
|
|
|
BarcodeValue |
|
String |
|
|
OutputContent
Definição: Conteúdo a ser exibido ou impresso.
Uso: Esta é uma sequência de elementos se eles tiverem formatos diferentes.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
Formato do conteúdo a ser exibido ou impresso. |
|
|
|
Estrutura de dados definida |
Referência de uma mensagem predefinida para exibição ou impressão. |
Obrigatório, se OutputFormat for MessageRef, não será permitido de outra forma. |
|
|
Estrutura de dados definida |
Conteúdo da mensagem de texto a ser exibida ou impressa. |
Obrigatório, se OutputFormat for Text, não permitido de outra forma. Uma instância do OutputText por formato compartilhado. |
|
OutputXHTML |
|
ByteSequence |
Corpo do documento XHTML que contém a mensagem a ser exibida ou impressa. |
Obrigatório, se OutputFormat for XHTML, não será permitido de outra forma. |
|
Estrutura de dados definida |
Conteúdo de código de barras para exibir ou imprimir. |
Obrigatório, se OutputFormat for BarCode, não será permitido de outra forma. |
OutputFormat
Nome: OutputFormat
Tipo: Enumeração
- MessageRef
- Text
- XHTML
- BarCode
OutputResult
Definição: Informações relacionadas ao resultado da output (exibição, impressão, entrada).
Uso: Na resposta da mensagem, ele contém o resultado da output, se necessário na solicitação de mensagem.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
Dispositivo lógico localizado em um terminal de vendas ou em um terminal de POI, em termos de classe de informações a serem exibidas (exibição, impressão ou armazenamento) ou entrada (teclado) do caixa ou do cliente. |
Cópia. |
|
|
Enumeration |
Qualificação das informações a serem enviadas para um dispositivo lógico de saída, para exibição ou impressão para o caixa ou cliente. |
Cópia. |
|
|
Estrutura de dados definida |
Resultado de um processamento de solicitação de mensagem. |
|
OutputText
Definição: Conteúdo da mensagem de texto a ser exibida ou impressa.
Uso: Transmite informações relacionadas ao conteúdo da mensagem de texto e seu formato. Todos os elementos de dados relacionados ao formato do texto a ser exibido ou impresso são parâmetros válidos para todo o conteúdo do texto.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
Text |
|
Unicode String |
|
|
CharacterSet |
|
Integer |
|
|
Font |
|
String |
|
|
StartRow |
|
Integer |
|
|
StartColumn |
|
Integer |
|
|
|
Enumeration |
|
|
|
|
Enumeration |
|
|
|
|
Enumeration |
|
|
|
|
Enumeration |
|
|
|
|
Enumeration |
|
|
|
EndOfLineFlag |
|
Boolean |
|
|
PaymentAccountReq
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
|
|
|
|
Estrutura de dados definida |
|
|
|
|
Estrutura de dados definida |
|
|
PaymentAccountStatus
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
|
|
|
CurrentBalance |
|
SimpleAmount |
|
|
Currency |
|
ISOCurrency |
|
|
|
Estrutura de dados definida |
|
|
PaymentAcquirerData
Definição: Dados relacionados à resposta do Adquirente de pagamento.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
AcquirerID |
|
DigitString |
Identificação do Adquirente. |
Se há vários adquirentes. |
MerchantID |
|
String |
Identificação do comerciante para o adquirente. |
|
AcquirerPOIID |
|
String |
Identificação do POI para o Adquirente de pagamento. |
|
|
Estrutura de dados definida |
Identificação da transação para o Adquirente. |
Se fornecido pelo Adquirente. |
|
ApprovalCode |
|
String |
Código atribuído a uma aprovação de transação pelo Adquirente. |
Se disponível. |
HostReconciliationID |
|
String |
|
|
PaymentData
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
|
|
|
SplitPaymentFlag |
|
Boolean |
|
|
RequestedValidityDate |
|
ISODate |
|
|
|
Estrutura de dados definida |
|
|
|
|
Estrutura de dados definida |
|
|
|
|
Estrutura de dados definida |
|
|
|
|
Estrutura de dados definida |
|
|
PaymentInstrumentData
Definição: Dados relacionados ao instrumento de pagamento da transação.
Uso: Enviado no resultado da transação de pagamento. Para um cartão, ele também pode ser enviado na resposta CardAcquisition, para ser processado pelo Sistema de Vendas.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
Tipo de instrumento de pagamento. |
|
|
ProtectedCardData |
|
ContentInformation |
|
|
|
Estrutura de dados definida |
Informações relacionadas ao cartão de pagamento usado para a transação. |
Se PaymentInstrumentType for 'Card' (cartão). |
|
|
Estrutura de dados definida |
Informações relacionadas ao cheque usado para a transação. |
Se PaymentInstrumentType é 'Check' (cheque). |
|
|
Estrutura de dados definida |
Informações relacionadas ao celular para a transação de pagamento. |
Se PaymentInstrumentType é 'Mobile'. |
|
|
Estrutura de dados definida |
|
|
PaymentInstrumentType
Nome: PaymentInstrumentType
Tipo: Enumeração
- Card
- Check
- Mobile
- StoredValue
- Cash
PaymentReceipt
Definição: Recibo de pagamento do cliente ou comerciante.
Uso: Se os recibos de pagamento forem impressos pelo sistema de vendas e o POI ou Sale não implementou a troca de impressões (perfil básico).
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
Qualificação do documento a ser impresso para o caixa ou cliente. |
SaleReceipt or CashierReceipt. |
|
IntegratedPrintFlag |
|
Boolean |
Tipo de impressão integrado a outras impressões. |
|
RequiredSignatureFlag |
|
Boolean |
Indica que o recibo de pagamento do titular do cartão requer uma assinatura física do Cliente. |
|
|
Estrutura de dados definida |
Conteúdo a ser exibido ou impresso. |
|
PaymentRequest
Definição: Conteúdo da mensagem de solicitação de pagamento.
Uso: Transmite informações relacionadas à transação de pagamento a serem processadas.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Dados relacionados ao sistema de vendas. |
|
|
|
Estrutura de dados definida |
Dados relacionados à transação de pagamento e fidelidade. |
|
|
|
Estrutura de dados definida |
Dados relacionados à transação de pagamento. |
Se um elemento de dados estiver presente. |
|
|
Estrutura de dados definida |
Dados relacionados a um programa ou conta de fidelidade. |
Cartões de fidelidade usados na transação de pagamento e lidos pelo sistema de vendas. |
PaymentResponse
Definição: Conteúdo da mensagem de resposta de pagamento.
Uso: Transmite informações relacionadas à transação de pagamento processada pelo sistema de POI.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Resultado de um processamento de solicitação de mensagem. |
|
|
|
Estrutura de dados definida |
Dados relacionados ao sistema de vendas. |
Cópia. |
|
|
Estrutura de dados definida |
Dados relacionados ao sistema POI. |
|
|
|
Estrutura de dados definida |
Dados relacionados ao resultado de uma transação de pagamento processada. |
Se um elemento de dados estiver presente. |
|
|
Estrutura de dados definida |
Dados relacionados ao resultado de uma transação de lealdade processada. |
Cartões de fidelidade usados na transação de pagamento. |
|
|
Estrutura de dados definida |
|
|
|
|
Estrutura de dados definida |
|
|
PaymentResult
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
|
|
|
|
Estrutura de dados definida |
|
|
|
|
Estrutura de dados definida |
|
|
|
|
Estrutura de dados definida |
Informações relacionadas a uma transação parcelada. Solicitar uma parcela ao emissor ou efetuar parcelas individuais de uma transação de pagamento. |
|
|
|
Estrutura de dados definida |
Informações relacionadas a uma conversão de moeda. Ocorreu uma conversão de moeda no pagamento, e o comerciante precisa conhecer as informações relacionadas a essa conversão (por exemplo, para imprimir no recibo da venda). |
|
|
MerchantOverrideFlag |
|
Boolean |
Indica que o comerciante forçou o resultado do pagamento com êxito. Permite que o sistema de vendas tenha certeza de que o pagamento foi forçado. |
|
|
Estrutura de dados definida |
Valor numérico de uma assinatura manuscrita. Contenha o valor de uma assinatura manuscrita, por exemplo, a assinatura de um titular de cartão no recibo de pagamento do comerciante. Somente um formato da assinatura é permitido, ele contém: O tamanho da área do bloco em que a assinatura é gravada, fornecida com os valores máximos de abscissa e ordenada. A sequência de coordenadas em que a caneta muda de direção ou de elevação. |
|
|
ProtectedSignature |
|
ContentInformation |
Valor numérico de uma assinatura manuscrita. Contenha o valor de uma assinatura manuscrita, por exemplo, a assinatura de um titular de cartão no recibo de pagamento do comerciante. O formato antes da criptografia é a estrutura de dados codificados CapturedSignature. A estrutura de dados antes da criptografia inclui as tags de início e fim de uma codificação XML, o identificador e o comprimento de bytes para uma codificação ASN.1 e o membro completo ProtectedSignature para uma codificação JSON. |
|
CustomerLanguage |
|
ISOLanguage |
Idioma do cliente. Permite a escolha do idioma do cliente quando o POI exibe mensagens ou imprime texto na interface do comerciante. |
|
OnlineFlag |
|
Boolean |
Indique que o processamento da transação de pagamento exigiu a aprovação de um host. Permite que o sistema de vendas saiba se o pagamento foi online ou offline. |
|
|
Cluster |
Método para autenticação do cliente. Permite que o sistema de vendas seja informado sobre a autenticação do cliente para a transação de pagamento. |
|
|
ValidityDate |
|
ISODate |
|
|
|
Estrutura de dados definida |
|
|
PaymentToken
Definição: Substituto do PAN (Primary Account Number) do cartão de pagamento para
identificar o meio de pagamento do cliente. Permite, para um comerciante, identificar
o cliente.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
Tipo de token que substitui o PAN de um cartão de pagamento para identificar o meio de pagamento do cliente. Ele permite que um comerciante use um token apenas para uma transação ou por um período mais longo.. |
|
|
TokenValue |
|
String |
Token de pagamento que substitui o PAN do cartão de pagamento para identificar o meio de pagamento do cliente. |
|
ExpiryDateTime |
|
ISODateTime |
Data e hora de vencimento. Limita a validade de um token de pagamento. |
|
PaymentTotals
Definição: Totals Totais da transação de pagamento durante o período de reconciliação.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
Tipo de transação para a qual os totals estão agrupados. |
Débito, Crédito, ReverseDebit, ReverseCredit, OneTimeReservation, CompletedDeffered, FirstReservation, UpdateReservation, CompletedReservation, CashAdvance. |
|
TransactionCount |
|
Integer |
Número de transações processadas durante o período. |
|
TransactionAmount |
|
SimpleAmount |
Soma do valor da transação processada durante o período. |
|
PaymentTransaction
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Vários valores relacionados à solicitação de pagamento e programa de fidelidade do sistema de vendas. |
|
|
|
Estrutura de dados definida |
|
|
|
|
Estrutura de dados definida |
|
|
|
|
Estrutura de dados definida |
|
|
PaymentType
Nome: PaymentType
Tipo: Enumeração
- Normal
- Refund
- OneTimeReservation
- FirstReservation
- UpdateReservation
- Completion
- CashAdvance
- CashDeposit
- Recurring
- Instalment
- IssuerInstalment
- PaidOut
PeriodUnit
Nome: PeriodUnit
Tipo: Enumeração
- Daily
- Weekly
- Monthly
- Annual
POICapabilities
Nome: POICapabilities
Tipo: Cluster
- CashierDisplay
- CashierError
- CashierInput
- CustomerDisplay
- CustomerError
- CustomerInput
- PrinterReceipt
- PrinterDocument
- PrinterVoucher
- MagStripe
- ICC
- EMVContactless
- CashHandling
POIData
Definição: Dados relacionados ao sistema POI.
Uso: Na resposta da mensagem, identificação da transação do POI.on.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Identificação exclusiva de uma transação de POI para um POI. |
|
|
POIReconciliationID |
|
DigitString |
Identificação do período de reconciliação entre venda e POI. |
Se Resultado for Sucess. |
Point
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
X |
|
HexString |
|
O comprimento da string deve ser maior ou igual a 1 e menor ou igual a 4 |
Y |
|
HexString |
|
O comprimento da string deve ser maior ou igual a 1 e menor ou igual a 4 |
POIProfile
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
|
|
|
|
Cluster |
|
|
POISoftware
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
ManufacturerID |
|
String |
|
|
ApplicationName |
|
String |
|
|
SoftwareVersion |
|
String |
|
|
CertificationCode |
|
String |
|
|
POIStatus
Definição: Estado de um terminal POI.
Uso: Indique a disponibilidade dos componentes do terminal POI. O elemento de dados está ausente se o componente não fizer parte do terminal POI.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
Status global de um servidor ou terminal de POI. |
|
|
SecurityOKFlag |
|
Boolean |
Indica se o módulo de segurança do POI está funcionando e é utilizável. |
Se houver módulo de segurança. |
PEDOKFlag |
|
Boolean |
Indica se o PED está funcionando e é utilizável. |
Se PED é presente. |
CardReaderOKFlag |
|
Boolean |
Indica se os leitores de cartão estão funcionando e são utilizáveis. |
Se houver um dispositivo leitor de cartão. |
|
Enumeration |
|
|
|
CommunicationOKFlag |
|
Boolean |
Indica se a infraestrutura de comunicação está funcionando e utilizável. |
Se houver infra-estrutura de comunicação. |
|
Estrutura de dados definida |
Status do dispositivo de manuseio de dinheiro. |
Se houver dispositivos de manuseio de dinheiro.. |
|
FraudPreventionFlag |
|
Boolean |
Indica uma suspeita de fraude pelo sistema POI. |
padrão False. |
POISystemData
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
DateTime |
|
ISODateTime |
|
|
|
Estrutura de dados definida |
|
|
|
|
Estrutura de dados definida |
|
|
|
|
Estrutura de dados definida |
|
|
POITerminalData
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
|
|
|
|
Cluster |
|
|
|
|
Estrutura de dados definida |
|
|
|
POISerialNumber |
|
String |
|
|
PredefinedContent
Definição: Referência de uma mensagem predefinida para exibição ou impressão.
Uso: Transmite informações relacionadas à mensagem predefinida.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
Identificação de uma mensagem predefinida para exibir ou imprimir. |
|
|
Language |
|
ISOLanguage |
Identificação de um idioma. |
|
PrinterStatus
Nome: PrinterStatus
Tipo: Enumeração
- OK
- PaperLow
- NoPaper
- PaperJam
- OutOfOrder
Rebates
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
TotalRebate |
|
SimpleAmount |
|
|
RebateLabel |
|
String |
|
|
|
Estrutura de dados definida |
|
|
ReconciliationRequest
Definição: Conteúdo da mensagem de solicitação de reconciliação.
Uso: Transmite informações relacionadas à reconciliação solicitadas pelo sistema de vendas.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
Tipo de reconciliação solicitada pela venda ao POI. |
|
|
AcquirerID |
|
DigitString |
Identificação do Adquirente. |
Pode estar presente apenas se ReconciliationType for 'AcquirerReconciliation' ou 'AcquirerSynchronisation'. |
POIReconciliationID |
|
DigitString |
Identificação do período de reconciliação entre Venda e POI. |
Ausente se ReconciliationType não for 'PreviousReconciliation'. |
ReconciliationResponse
Definição: Conteúdo da mensagem de resposta de reconciliação.
Uso: Transmite informações relacionadas à transação de reconciliação processada pelo sistema POI.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Resultado de um processamento de solicitação de mensagem. |
|
|
|
Enumeration |
Tipo de reconciliação solicitada pela venda ao POI. |
Copy. |
|
POIReconciliationID |
|
DigitString |
Identificação do período de reconciliação entre Venda e POI. |
Ausente se ReconciliationType for 'AcquirerReconciliation'. |
|
Estrutura de dados definida |
Resultado do processo de reconciliação de venda para POI. |
se Response.Result for Success. |
ReconciliationType
Nome: ReconciliationType
Tipo: Enumeração
- SaleReconciliation
- AcquirerSynchronisation
- AcquirerReconciliation
- PreviousReconciliation
ReferenceID
Nome: ReferenceID
Tipo: Enumeração
- Accepted: Mostra uma tela 'Approved' sem uma animação "OK".
- AcceptedAnimated: Mostra a tela 'Approved' regular.
- AcceptedCustom: Mostra uma tela 'Approved' com uma animação personalizada.
- Declined: Mostra uma tela 'Declined' sem uma animação "X".
- DeclinedAnimated: Mostra a tela 'Declined' regular.
- Custom: Não mostra nenhuma animação e usa a cor de fundo padrão.
RepeatedMessageResponse
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
|
|
|
|
Estrutura de dados definida |
|
|
RepeatedResponseMessageBody
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
|
|
|
|
Estrutura de dados definida |
|
|
|
|
Estrutura de dados definida |
|
|
|
|
Estrutura de dados definida |
|
|
|
|
Estrutura de dados definida |
|
|
|
|
Estrutura de dados definida |
|
|
Response
Definição: Resultado de um processamento de solicitação de mensagem.
Uso: Se resultado for bem-sucedido, ErrorCondition está ausente ou não é usado no processamento da mensagem. Nos outros casos, a ErrorCondition deve estar presente e pode refinar o processamento da resposta da mensagem. O AdditionalResponse fornece mais informações sobre o sucesso ou a falha do processamento da solicitação de mensagens, para registro sem envolvimento em tempo real.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
Resultado do processamento da mensagem. |
|
|
|
Enumeration |
Condição que produziu um erro no processamento de uma solicitação de mensagem. |
Se o resultado não for um sucesso. |
|
AdditionalResponse |
|
String |
Informações adicionais relacionadas ao status de processamento de uma solicitação de mensagem. |
Se presente, o POI registra-o para um exame mais aprofundado. |
Result
Nome: Result
Tipo: Enumeração
- Success
- Failure
- Partial
ReversalReason
Nome: ReversalReason
Tipo: Enumeração
- CustCancel
- MerchantCancel
- Malfunction
- Unable2Compl
ReversalRequest
Definição: Conteúdo da mensagem de solicitação de reversão.
Uso: Transmite informações relacionadas à reversão de um pagamento anterior ou de uma transação de fidelidade.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
|
|
|
|
Estrutura de dados definida |
Identificação de uma transação POI anterior. |
|
|
ReversedAmount |
|
SimpleAmount |
Valor do pagamento ou lealdade a reverter. |
ReversedAmount é implicitamente o AuthorizedAmount se ausente. |
|
Enumeration |
Razão do estorno do pagamento ou da lealdade. |
|
|
|
Estrutura de dados definida |
|
|
ReversalResponse
Definição: Conteúdo da mensagem de resposta de reversão.
Uso: Transmite informações relacionadas à reversão processada pelo sistema POI.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Resultado de um processamento de solicitação de mensagem. |
|
|
|
Estrutura de dados definida |
Dados relacionados ao sistema POI. |
Se Resultado for Sucesso. |
|
|
Estrutura de dados definida |
|
|
|
ReversedAmount |
|
SimpleAmount |
Valor do pagamento ou fidelidade a reverter. |
Cópia. |
|
Estrutura de dados definida |
|
|
|
|
Estrutura de dados definida |
|
|
SaleCapabilities
Nome: SaleCapabilities
Tipo: Cluster
- CashierStatus
- CashierError
- CashierDisplay
- POIReplication
- CashierInput
- CustomerAssistance
- CustomerDisplay
- CustomerError
- CustomerInput
- PrinterReceipt
- PrinterDocument
- PrinterVoucher
- MagStripe
- ICC
- EMVContactless
SaleData
Definição: Dados relacionados ao sistema de vendas.
Uso: Dados associados ao sistema de venda, com um valor específico durante o processamento do pagamento pelo POI, incluindo a aquisição de cartões.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
OperatorID |
|
String |
|
|
OperatorLanguage |
|
ISOLanguage |
Idioma do caixa ou operador. |
se diferente do Login. |
ShiftNumber |
|
String |
Número do turno. |
Se for diferente do Login e consulte Login .SaleData. |
|
Estrutura de dados definida |
Identificação exclusiva de uma transação de venda. |
|
|
SaleReferenceID |
|
String |
Identificação de uma transação global de venda para uma sequência de transações de POI relacionadas. |
Se reserva de pagamento. |
|
Estrutura de dados definida |
Informações relacionadas ao recurso de software e hardware do Terminal de vendas. |
Se o conteúdo não estiver vazio |
|
|
Enumeration |
Tipo de token que substitui o PAN de um cartão de pagamento para identificar o meio de pagamento do cliente. Ele permite que um comerciante use um token apenas para uma transação ou por um período mais longo. |
|
|
CustomerOrderID |
|
String |
Identificação adicional e opcional de um pedido do cliente. |
|
|
Cluster |
Lista de pedidos do cliente abertos, fechados ou ambos a serem enviados nas mensagens de resposta. |
|
|
SaleToPOIData |
|
String |
SInformações de venda destinadas ao POI. |
Armazenado com a transação. |
SaleToAcquirerData |
|
String |
Informações de venda destinadas ao Adquirente. |
Envie ao Adquirente, se presente. |
|
Estrutura de dados definida |
Informações de venda destinadas ao emissor. |
Envie ao Adquirente, se presente. |
SaleItem
Definition: Itens de venda de uma transação.
Usage: Na transação de fidelidade ou cartão de pagamento com valor agregado, os itens da venda entram no processamento da transação.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
ItemID |
|
Integer |
Identificação do item dentro de uma transação (0 a n). |
|
ProductCode |
|
DigitString |
Código do produto do item adquirido com a transação. |
O comprimento da string deve ser maior ou igual a 1 e menor ou igual a 20. |
EanUpc |
|
DigitString |
Código padrão do produto do item adquirido com a transação. |
Se os dados forem enviados, o POI deve armazená-los e enviá-los se o protocolo do host permitir. |
|
Enumeration |
Unidade de medida de uma quantidade. |
Se Quantity é presente. |
|
Quantity |
|
Decimal |
Quantidade de produto. |
Se os dados forem enviados, o POI deve armazená-los e enviá-los se o protocolo do host permitir. |
UnitPrice |
|
SimpleAmount |
Preço por unidade de produto. |
Se Quantity é presente. |
ItemAmount |
|
SimpleAmount |
Valor total da linha do item |
|
TaxCode |
|
DigitString |
Tipo de impostos associados ao item de linha. |
Se os dados forem enviados, o POI deve armazená-los e enviá-los se o protocolo do host permitir. |
SaleChannel |
|
DigitString |
Canal comercial ou de distribuição associado ao item de linha. |
Se os dados forem enviados, o POI deve armazená-los e enviá-los se o protocolo do host permitir. |
ProductLabel |
|
String |
|
|
AdditionalProductInfo |
|
String |
Informações adicionais relacionadas ao item de linha. |
Se os dados forem enviados, o POI deve armazená-los e enviá-los se o protocolo do host permitir. |
SaleItemRebate
Definição: O valor concedido que é anexado a um item como um reembolso.
Uso: Ser diferente do award which que é o valor ou a quantidade conquistada na conta de fidelidade.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
ItemID |
|
Integer |
Identificação do item dentro de uma transação (0 a n). |
|
ProductCode |
|
DigitString |
Código do produto do item adquirido com a transação. |
O comprimento da string deve ser maior ou igual a 1 e menor ou igual a 20 |
EanUpc |
|
DigitString |
|
|
|
Enumeration |
Unidade de medida de uma quantidade. |
Se Quantity é presente. |
|
Quantity |
|
Decimal |
Quantidade de produto. |
se o desconto for unidades adicionais. |
ItemAmount |
|
SimpleAmount |
Valor total da linha do item. |
se reembolso no valor do item de linha. |
RebateLabel |
|
String |
Texto breve para qualificar um desconto em um item de linha. |
Se fornecido pelo Adquirente. |
SaleProfile
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
|
|
|
|
Cluster |
|
|
SaleSoftware
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
ManufacturerID |
|
String |
|
|
ApplicationName |
|
String |
|
|
SoftwareVersion |
|
String |
|
|
CertificationCode |
|
String |
|
|
SaleTerminalData
Definição: Informações relacionadas ao recurso de software e hardware do Terminal de Vendas.
Uso: Na Solicitação de Login, se um terminal de vendas estiver envolvido no login. Em outras mensagens, quando um dispositivo lógico está com defeito (SaleCapabilites) ou quando os outros dados foram alterados desde ou não estavam no Login.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
Ambiente do Terminal. |
|
|
|
Cluster |
Recursos de hardware do Terminal de Vendas. |
|
|
|
Estrutura de dados definida |
Perfil funcional do terminal de vendas. |
Se pelo menos um elemento estiver presente. |
|
TotalsGroupID |
|
String |
Identificação de um grupo de transações em um terminal de POI, com os mesmos recursos de venda. |
Se presente, valor padrão para todas as transações. O comprimento da string deve ser maior ou igual a 1 e menor ou igual a 16 |
SaleToIssuerData
Definição: Informações de venda destinadas ao emissor.
Uso: O Sistema POI recebe essas informações e as envia ao Adquirente para o Emissor sem nenhuma alteração.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
StatementReference |
|
String |
R'ltulo para imprimir no extrato bancário. |
Informações para imprimir no extrato bancário. |
SecurityTrailer
Definição: SecurityTrailer, usado pela Adyen.
Uso: Ele contém informações relacionadas à segurança da mensagem.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
AdyenCryptoVersion |
|
Integer |
|
|
KeyIdentifier |
|
String |
|
|
KeyVersion |
|
Integer |
|
|
Nonce |
|
ByteSequence |
|
|
Hmac |
|
ByteSequence |
|
|
SensitiveCardData
Definição: Informações confidenciais relacionadas ao cartão de pagamento, inseridas ou lidas
pelo sistema de vendas.
Uso: Essa estrutura de dados pode ser protegida por CMS (EnvelopedData). Nesse caso, a estrutura de dados
SensitiveCardData é substituída pela estrutura de dados ProtectedCardData do tipo
ContentInformationType.
Quando esses dados são protegidos, o conteúdo exato é desconhecido pelo sistema de vendas e pode incluir
todas as informações exigidas por um servidor POI de backup externo para fazer uma
transação de pagamento em lote em caso de problemas com o sistema POI.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
PAN |
|
DigitString |
Número da conta principal. |
O comprimento da string deve ser maior ou igual a 8 e menor ou igual a 28 |
CardSeqNumb |
|
DigitString |
Número de sequência do cartão. |
Se EntryMode for Arquivo, Chave ou Manual. O comprimento da string deve ser maior ou igual a 2 e menor ou igual a 3 |
ExpiryDate |
|
DigitString |
Data após a qual o cartão não pode ser usado. |
Se EntryMode for File. O comprimento da string deve ser exatamente 4 |
|
Estrutura de dados definida |
Faixa magnética ou linha de caracteres de tinta magnética. |
Se EntryMode for MagStripe ou RFID. |
SensitiveMobileData
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
MSISDN |
|
DigitString |
|
|
ISMI |
|
DigitString |
|
|
IMEI |
|
DigitString |
|
|
ServiceProfiles
Nome: ServiceProfiles
Tipo: Cluster
- Synchro
- Batch
- OneTimeRes
- Reservation
- Loyalty
- StoredValue
- PIN
- CardReader
- Sound
- Communication
ServicesEnabled
Nome: ServicesEnabled
Tipo: Cluster
- CardAcquisition
- Payment
- Loyalty
StoredValueAccountID
Definição: Identificação da conta do valor armazenado ou do cartão de valor armazenado.
Uso: Contém as identificações da conta de valor armazenado ou do cartão de valor armazenado e o produto associado vendido pelo sistema de venda para solicitações de valor armazenado.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
|
|
|
StoredValueProvider |
|
String |
|
|
OwnerName |
|
String |
|
|
ExpiryDate |
|
DigitString |
|
O comprimento da string deve ser exatamente 4 |
|
Cluster |
|
|
|
|
Enumeration |
|
|
|
StoredValueID |
|
String |
|
|
StoredValueAccountStatus
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
|
|
|
CurrentBalance |
|
SimpleAmount |
|
Se relevante e conhecido. |
StoredValueAccountType
Nome: StoredValueAccountType
Tipo: Enumeração
- GiftCard
- PhoneCard
- Other
StoredValueData
Definição: Dados relacionados ao cartão de valor armazenado.
Usage: Contém a identificação das contas de valor armazenado ou dos cartões de valor armazenado, se fornecidos pelo sistema de venda, e os produtos associados vendidos pelo sistema de senda.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
StoredValueProvider |
|
String |
Identificação do provedor da conta de valor armazenado load/reload. |
Se houver mais de um provedor para gerenciar no POI e StoredValueAccountID ausente. |
|
Enumeration |
Identification of operation to proceed on the stored value account or the stored value card. |
|
|
|
Estrutura de dados definida |
Identificação da conta do valor armazenado ou do cartão de valor armazenado. |
Se a identificação da conta ou cartão do valor armazenado tiver sido feita pelo Sistema de Venda antes da solicitação. |
|
|
Estrutura de dados definida |
Identificação de uma transação POI anterior. |
Se StoredValueTransactionType for Reverse ou Duplicate. |
|
ProductCode |
|
DigitString |
Código do produto do item adquirido com a transação. |
O comprimento da string deve ser maior ou igual a 1 e menor ou igual a 20 |
EanUpc |
|
DigitString |
Código padrão do produto do item adquirido com a transação. |
|
ItemAmount |
|
SimpleAmount |
Valor total da linha do item. |
|
Currency |
|
ISOCurrency |
Moeda de um valor monetário. |
|
StoredValueRequest
Definição: Conteúdo da mensagem Stored Value Request.
Uso: Transmite as informações relacionadas à transação do valor armazenado para processar.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Dados relacionados ao sistema de vendas. |
|
|
CustomerLanguage |
|
ISOLanguage |
Idioma do cliente. |
Se o idioma for selecionado pelo sistema de vendas antes da solicitação ao POI. |
|
Estrutura de dados definida |
Dados relacionados ao cartão de valor armazenado. |
|
StoredValueResponse
Definição: Conteúdo da mensagem Value Response.
Uso: Transmite informações relacionadas à transação de valor armazenado processada pelo sistema POI.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Resultado de um processamento de solicitação de mensagem. |
|
|
|
Estrutura de dados definida |
Dados relacionados ao sistema de vendas. |
|
|
|
Estrutura de dados definida |
Dados relacionados ao sistema POI. |
|
|
|
Estrutura de dados definida |
Resultado do carregamento / recarregamento de um cartão de valor armazenado. |
Se StoredValueResponse.Result for 'Success' ou 'Partial', uma entrada por StoredValueRequest.StoredValueData carregada ou ativada. |
|
|
Estrutura de dados definida |
|
|
StoredValueResult
Definição: Resultado do carregamento/recarregamento de um cartão de valor armazenado.
Uso: Para cada cartão de valor armazenado carregado ou recarregado, na mensagem de resposta StoredValue.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descriçãso | Regra |
---|---|---|---|---|
|
Enumeration |
Identificação da operação para prosseguir na conta de valor armazenado ou no cartão de valor armazenado. |
Cópia. |
|
ProductCode |
|
DigitString |
Código do produto do item adquirido com a transação. |
Cópi. O comprimento da string deve ser maior ou igual a 1 e menor ou igual a 20 |
EanUpc |
|
DigitString |
Código padrão do produto do item adquirido com a transação. |
Cópia. |
ItemAmount |
|
SimpleAmount |
Valor total da linha do item. |
|
Currency |
|
ISOCurrency |
Moeda de um valor monetário. |
Cópia. |
|
Estrutura de dados definida |
Dados relacionados ao resultado da transação do cartão de valor armazenado. |
|
|
|
Estrutura de dados definida |
Identificação da transação pelo host responsável pela transação de valor armazenado. |
Se fornecido pelo host. |
StoredValueTransactionType
Nome: StoredValueTransactionType
Tipo: Enumeração
- Reserve
- Activate
- Load
- Unload
- Reverse
- Duplicate
TerminalEnvironment
Nome: TerminalEnvironment
Tipo: Enumeração
- Attended
- SemiAttended
- Unattended
TokenRequestedType
Nome: TokenRequestedType
Tipo: Enumeração
- Transaction
- Customer
TotalDetails
Nome: TotalDetails
Tipo: Enumeração
- POIID
- SaleID
- OperatorID
- ShiftNumber
- TotalsGroupID
TotalFilter
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descriçãso | Regra |
---|---|---|---|---|
POIID |
|
String |
|
|
SaleID |
|
String |
|
|
OperatorID |
|
String |
|
|
ShiftNumber |
|
String |
|
|
TotalsGroupID |
|
String |
|
O comprimento da string deve ser maior ou igual a 1 e menor ou igual a 16 |
TrackData
Definição: Faixa magnética ou linha de caracteres de tinta magnética..
Uso: Estrutura de dados genérica para uma faixa de cartão, usada quando o
leitor de cartão de tarja magnética está localizado no terminal de venda ou para solicitação de dispositivo de leitor de cartão de tarja magnética.
A estrutura de dados também é usada para armazenar a linha na parte inferior de um cheque bancário.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descriçãso | Regra |
---|---|---|---|---|
TrackNumb |
|
Integer |
|
|
|
Enumeration |
|
|
|
TrackValue |
|
String |
|
O comprimento da cadeia deve ser maior ou igual a 1 e menor ou igual a 104 |
TrackFormat
Nome: TrackFormat
Tipo: Enumeração
- ISO
- JIS-I
- JIS-II
- AAMVA
- CMC-7
- E-13B
TransactionAction
Nome: TransactionAction
Tipo: Enumeração
- StartTransaction
- AbortTransaction
TransactionConditions
Definição: Condições nas quais a transação deve ser processada.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
AllowedPaymentBrand |
|
String |
Bandeira des cartão permitidas pelo sistema de venda para a transação de pagamento. |
Restrinja a bandeira se os dados forem enviados. |
AcquirerID |
|
DigitString |
Identificação do Adquirente. |
Restrinja a este Adquirente, se presente. |
DebitPreferredFlag |
|
Boolean |
O tipo de pagamento preferido é uma transação de débito e não uma transação de crédito. |
O tipo de pagamento preferido é uma transação de débito e não uma transação de crédito |
AllowedLoyaltyBrand |
|
String |
Marcas ou programas de fidelidade permitidos pelo sistema de venda para a transação de fidelidade. |
Restrinja a bandeira se os dados forem enviados. |
|
Enumeration |
Tipo de processamento de programa fidelidade solicitado pelo sistema de vendas |
|
|
CustomerLanguage |
|
ISOLanguage |
Idioma do cliente. |
Se o idioma for selecionado pelo sistema de vendas antes da solicitação ao POI. |
ForceOnlineFlag |
|
Boolean |
Indica se o caixa exige o POI force o acesso on-line ao Adquirente. |
Fique online se os dados forem enviados. |
|
Cluster |
Modo de entrada do instrumento de pagamento solicitado pelo sistema de vendas. |
Restrinja o modo de entrada se enviado. |
|
MerchantCategoryCode |
|
String |
O código que identifica a categoria da transação (MCC). |
O pagamento implica uma MCC específica. O comprimento da sequência deve ser maior ou igual a 3 e menor ou igual a 4 |
TransactionIDType
Definição: Identificação de uma transação para o sistema de vendas ou o sistema de POI.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
TransactionID |
|
String |
Unique Identificação exclusiva de uma transação. Para identificar a transação no sistema de vendas (por exemplo, número do bilhete) ou no sistema de POI. |
|
TimeStamp |
|
ISODateTime |
Data e hora de uma transação para o sistema de vendas, o sistema de POI ou o adquirente. Garante a exclusividade de uma transação e indica a hora em que o evento ocorre na mensagem EventNotification. |
|
TransactionStatusRequest
Definição: Conteúdo da mensagem de solicitação TransactionStatus.
Uso: Este transmite as informações solicitadas para o status da última ou atual transação de pagamento, fidelidade ou estorno.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Identificação de uma transação POI anterior. |
Presente se contiver algum dado. |
|
ReceiptReprintFlag |
|
Boolean |
Pedido para reimprimir os recibos de POI. |
|
|
Enumeration |
|
|
TransactionStatusResponse
Definição: Conteúdo da mensagem de resposta do TransactionStatus.
Uso: Transmite informações relacionadas ao status da última ou atual transação de pagamento, fidelidade ou estorno.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Estrutura de dados definida |
Resultado de um processamento de solicitação de mensagem. |
|
|
|
Estrutura de dados definida |
Identificação de uma transação POI anterior. |
se Response.Result for Success. |
|
|
Estrutura de dados definida |
Conteúdo da resposta da mensagem solicitada. |
Se o resultado for sucesso (processo concluído). |
TransactionTotals
Definição: Resultado do processamento de reconciliação de venda para POI.
Uso: Se resultado for bem-sucedido, contém todos os totals, classificados conforme exigido por Sale na solicitação de mensagem. Finalmente, os totais da transação são fornecidos por adquirente, liquidação do adquirente e bandeira do cartão.
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
|
Enumeration |
Tipo de instrumento de pagamento. |
|
|
AcquirerID |
|
DigitString |
Identificação do Adquirente |
Se disponível. |
HostReconciliationID |
|
String |
Identificador de um período de reconciliação com um host de pagamento ou fidelidade. |
Se disponível. |
CardBrand |
|
String |
Tipo de pagamento ou cartão fidelidade. |
Se configurado para apresentar totals por marca de cartão, e Response.Result for Success. |
POIID |
|
String |
Identificação de um sistema de POI ou de um terminal de POI para o protocolo de venda para POI. |
Se solicitado na solicitação de mensagem. |
SaleID |
|
String |
Identificação de um sistema de venda ou de um terminal de venda para o protocolo Sale to POI. |
Se solicitado na solicitação de mensagem. |
OperatorID |
|
String |
Identificação do caixa ou operador. |
Se solicitado na solicitação de mensagem.. |
ShiftNumber |
|
String |
Número do turno. |
Se solicitado na solicitação de mensagem |
TotalsGroupID |
|
String |
Identificação de um grupo de transações em um terminal de POI, com os mesmos recursos de venda. |
Se solicitado na solicitação de mensagem. O comprimento da string deve ser maior ou igual a 1 e menor ou igual a 16 |
PaymentCurrency |
|
ISOCurrency |
Moeda de um valor monetário.. |
|
|
Estrutura de dados definida |
Totals da transação de pagamento durante o período de reconciliação. |
Se TransactionCount e TransactionAmount não forem iguais a zero. |
|
|
Enumeration |
Unidade de um valor de lealdade. |
|
|
LoyaltyCurrency |
|
ISOCurrency |
Moeda de um valor monetário. |
Se LoyaltyUnit for Monetário. |
|
Estrutura de dados definida |
Totais da transação de fidelidade durante o período de reconciliação. |
Se TransactionCount e TransactionAmount não forem iguais a zero. |
TransactionType
Nome: TransactionType
Tipo: Enumeração
- Debit
- Credit
- ReverseDebit
- ReverseCredit
- OneTimeReservation
- CompletedDeffered
- FirstReservation
- UpdateReservation
- CompletedReservation
- CashAdvance
- IssuerInstalment
- Declined
- Failed
- Award
- ReverseAward
- Redemption
- ReverseRedemption
- Rebate
- ReverseRebate
TypeCode
Nome: TypeCode
Tipo: Enumeração
- Personal
- Company
UnitOfMeasure
Nome: UnitOfMeasure
Tipo: Enumeração
- Case
- Foot
- UKGallon
- USGallon
- Gram
- Inch
- Kilogram
- Pound
- Meter
- Centimetre
- Litre
- Centilitre
- Ounce
- Quart
- Pint
- Mile
- Kilometre
- Yard
- Other
UTMCoordinates
Tipo: Estrutura de dados definida
Componente | Requerimento | Tipo | Descrição | Regra |
---|---|---|---|---|
UTMZone |
|
String |
|
|
UTMEastward |
|
String |
|
|
UTMNorthward |
|
String |
|
|