--- title: "Definição dos campos" url: "https://devcenter.stone.com.br/autotef-definicao-dos-campos" image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_~RGVmaW5pw6fDo28gZG9zIGNhbXBvcw,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9hdXRvdGVmLWRlZmluaWNhby1kb3MtY2FtcG9zIg,s_2O-uqzdBjQT7EKNa.png" --- # Definição dos campos Tabelas com as definições de cada campo no request e response ## [Campos do Request](#campos-do-request) | Campo | Tipo | Descrição | | :------------------------ | :--------------- | :------------------------------------------------------------------------------- | | amount | decimal | Valor de captura do pagamento - Valor da Transação | | accountType | string | * Undefined: - deixa a definição de tipo de transação para o usuário escolher no pinpad; * Debit: define a transação para Débito; * Credit: define a transação para Crédito; * Voucher: define a transação para Voucher. | | installment | object | Objeto que configura os valores de transações Parceladas. | | * type | integer | Tipo do parcelamento: * Sem Parcelamento: 1 * Merchant: 2 - Parcelado lojista (Sem juros para o cliente) * Issuer: 3 - Parcelado emissor (Com juros para o cliente) | | * number | integer | Número de parcelas da transação para os casos de Merchant e Issuer.\ Credito é possível parcelas de 2 a 18 vezes. Debito = 0 Credito á vista = 1 OBS: Parcelado de 13 a 18x, tem valor mínimo por parcela de 10 reais | | hasAlcoholicDrink | booleam | Tem como padrão o valor false. Informe true em caso de bloqueio de produtos Alcoólicos ou Cigarros. Segundo o normativo PAT (Programa de Alimentação do Trabalhador) é vetado a venda de produtos alcoólicos ou cigarros com cartões Voucher (refeição, alimentação, cultura e etc..) | | splits | array of objects | Lista de objetos que configuram os recebedores (Apenas para parceiros Pagar-me. Para saber mais, fale com seu Bizdev(Account Manager). | | * amount | integer | Valor destinado ao recebedor. | | * splitType | string | Tipo de divisão. Os valores possíveis são flat ou percentage. Flat é o valor inteiro.\ Flat ; Percentage; | | * recipientIdentification | string | Código do recebedor. Formato: rp_XXXXXXXXXXXXXXXX. | | * changeProcessingFee | booleam | Indica se o recebedor vinculado à regra será cobrado pelas taxas da transação | | * chargeRemainderFee | booleam | Indica se o recebedor vinculado à regra irá receber o restante dos recebíveis após uma divisão. | | * liable | booleam | Indica se o recebedor é responsável pela transação em caso de chargeback. | ## [Campos do Response](#campos-do-response) Os campos do retorno da API, são necessários para montagem do cupom e para uso na rota de cancelamento quando for o caso. | Campo | Tipo | Observação | | :--------------------------- | :------ | :------------------------------------------------------------------------------- | | brandName | string | Marca retornada pelo emissor do cartão. exemplo: “MASTER CREDITO” | | receipt | object | | | * acquirerTransactionKey | string | Identificador único da transação ( Identificador gerado pelo autorizador, único para cada transação. Utiliza-se a mesma ATK entre os eventos; | | * aid | string | Identificador da aplicação. Apenas para transações com chip/NFC/EMV; ( Código único gerado pelo AutoTEF para identificar e determinar a inicialização da transação. Deve ser formatado seguindo a seguinte regra: nnnnnnddmmyyyyHHMMSS sendo que nnnnnn=número sequencial gerado pelo AutoTEF.) | | * amount | decimal | Valor da transação; | | * arqc | string | criptograma ARQC para efetuar a transação em modo online; | | * availableBalance | decimal | Saldo disponível para transações de voucher; | | * brandName | string | Marca e modalidade da bandeira,\ exemplo: “MASTER CREDITO” | | * cardholderName | string | Nome do titular do cartão | | * initiatorTransactionKey | string | ITK - ID único enviado pela SDK/Slim para o Autorizador Stone. | | * installmentType | integer | Tipo de parcela: * Sem Parcelamento= 1; * Merchant = 2 (Parcelado por decisão do estabelecimento comercial); * Issuer = 3 (Parcelado com juros, decisão do emissor). | | * totalNumberOfPayments | integer | Número de parcelas | | * maskedPrimaryAccountNumber | string | Dados do Pan do cartão mascarado. | | * systemSpecifications | string | especificação do sistema. | | * transactionDateTime | string | Data e hora da transação. | | * transactionType | integer | Indica o tipo da transação. * Debit = 1; * Credit= 2; * Voucher = 7. | | * clientVia | string | Cupom do cliente já formatado para impressão | | * merchantVia | string | Cupom do estabelecimento já formatado para impressão | | * cardReadingType | integer | Modo de entrada da transação/cartão;\ Segue modelos de entrada transação possíveis: * Undefined = 0; * MagneticStrip = 4 (Tarja magnética); * Chip = 5 (ICC); * Contactless = 7 (NFC simula tarja); * EMVProximityReader = 8 (NFC simula chip) | | * cardNeedsPassword | boolean | Cartão precisa de senha ou não. * False (Não necessita de senha); * True (Necessita de senha). | | * authorisationCode | string | Código de autorização retornado pelo emissor do cartão | | * messageDisplay | string | Mensagem do retorno do autorizador. | | * isVoucher | boolean | Indica se o cartão é Voucher (Sodexo, VR, Ticket ou Alelo). * False (Não é cartão voucher); * True (Cartão Voucher); | | * merchantName | string | Nome do estabelecimento | | * merchantDocument | string | Cnpj do estabelecimento | | * merchantAddress | string | Endereço do estabelecimento | | * merchantCity | string | Cidade do estabelecimento | | * merchantZipCode | string | CEP do estabelecimento | | * totalAmountReversal | string | Valor de reversão do valor da bandeira Ticket. | | * cne | string | Cardholder Name Extended (Tag EMV 9F0B). Mandatório na via do estabelecimento em transação de autorização chip. | | * retrievalReferenceNumber | string | RRN (RetrievalReferenceNumber): Retorna o conteúdo do campo. Mandatório em todas as vias, autorização/estorno, chip/tarja e cliente e EC. IssuerTransactionIdentification. | | * productBrandCard | string | Produto da bandeira utilizada na transação. | | * stoneCode | string | Código único de identificador do estabelecimento na Stone. | | card | object | Objeto cartão do portador. | | * brandId | integer | Id da marca na carga de tabela | | * brandName | string | Marca e modalidade da bandeira,\ exemplo: “MASTER CREDITO” | | * cardholderName | string | Nome do portador do cartão | | * expirationDate | string | Data de expiração do cartão | | * maskedPrimaryAccountNumber | string | PAN mascarado | | * cardType | integer | Modo de entrada do cartão; * Undefined = 0; * Emv = 1 (ICC ou NFC simula Chip); * MagneticStrip = 2 (Tarja magnética); * Contactless = 3 (NFC simula tarja); | | * applicationId | string | | | * applicationCryptogram | string | | | * needsPassword | boolean | | | * maskedPan | string | Pan mascarado para uso em caso de cancelamento do pagamento via PDV. | Alguns campos aparecem repetidos, porém podem conter dados diferentes. Estamos trabalhando para melhorar e universalizar esse retorno. Fique atendo a lei de LGPD. Em sua maioria os dados aqui retornados, devem ser usados apenas para compor o cupom da transação. Salvo apenas os campos necessários para executar a rota de cancelamento em um PDV. Que exige validação com a apresentação do cartão utilizado na transação. --- **Jornada: [Cobrar com cartão e Pix](https://devcenter.stone.com.br/autotef-autorizacao)** Etapa 2 de 10 [**Etapa anterior**Autorização](https://devcenter.stone.com.br/autotef-autorizacao)[**Próxima etapa**Autorização: Split](https://devcenter.stone.com.br/autotef-split) Siga a Stone nas redes sociais [](https://www.facebook.com/stonepagamentos/)[](https://x.com/sejastone/)[](https://www.instagram.com/stone/)[](https://br.linkedin.com/company/stone-co)[](https://www.youtube.com/channel/UCk4L4JykgoDkN8YeuxkNqIQ) © Stone Instituição de Pagamento S.A. CNPJ 16.501.555/0001-57 Av. Rebouças, 2880, 4º andar, Pinheiros, CEP 05.402-500 – São Paulo/SP Instituição de pagamento autorizada pelo Banco Central do Brasil, nas modalidades de credenciadora e emissora de moeda eletrônica.