O TransactionObject é o objeto que contém todas as informações relacionadas à uma transação e possui os seguintes atributos:
| Campo | Tipo | Descrição |
|---|---|---|
| acquirerTransactionKey | String | Identificador único da transação gerado pela Stone. Conhecido como StoneID ou ATK (Acquirer Transaction Key). |
| initiatorTransactionKey | String | Identificação da transação definido pela sua aplicação (ITK). |
| amount | String | Valor da transação no formato de centavos (ex: 10,00 vai ser 1000. Basta multiplicar por 0.01 para obter o valor real). |
| typeOfTransaction | typeOfTransactionEnum | Débito ou crédito. |
| instalmentTransaction | InstalmentTransactionEnum | Número de parcelas da transação. |
| instalmentType | InstalmentTypeEnum | Tipo de parcelamento da transação. |
| cardHolderNumber | String | 4 últimos número do cartão. |
| cardBrandName | String | Bandeira do cartão. |
| cardHolderName | String | Nome do portador do cartão. |
| authorizationCode | String | Código de autorização gerado pelo Emissor. |
| transactionStatus | TransactionStatusEnum | Aprovada, cancelada, negada. |
| date | String | Data da transação. |
| shortName - Parceiros: opcional - Subadquirentes: Obrigatório | String | Nome fantasia do estabelecimento¹ (aparecerá na fatura do portador). Deve obrigatoriamente corresponder ao principal nome utilizado pelo estabelecimento. Campo obrigatório para subadquirentes, porém não restritivo à elas. ¹ Se o estabelecimento comercial faz parte do segmento de casas de câmbio, para transações da bandeira Mastercard será necessário identificar na tagShrtNm da autorização. Exemplo: nomedomerchant*cambio. |
| userModel | userModel | Dados cadastrais do lojista que passou a transação. |
| pinpadUsed | String | Pinpad que passou a transação. |
| balance | String | Saldo do voucher (ex.: Ticket, Pluxee). |
| capture | Boolean | Define se a transação será/foi realizada com captura automática ou não. |
| subMerchantCategoryCode - Parceiros: Não devem utilizar - Subadquirentes: Obrigatório | String | MCC do lojista que efetuou a transação . |
| subMerchantAddress - Parceiros: Não devem utilizar - Subadquirentes: Obrigatório | String | Endereço do lojista que efetuou a transação. |
| subMerchantCity - Parceiros: Não devem utilizar - Subadquirentes: Obrigatório | String | Cidade do estabelecimento sub-merchant. |
| subMerchantPostalAddress - Parceiros: Não devem utilizar - Subadquirentes: Obrigatório | String | CEP do estabelecimento sub-merchant. |
| subMerchantStreetName - Parceiros: Não devem utilizar - Subadquirentes: Obrigatório | String | Logradouro do estabelecimento sub-merchant. |
| subMerchantTaxIdentificationNumber - Parceiros: Não devem utilizar - Subadquirentes: Obrigatório | String | CNPJ/CPF do estabelecimento sub-merchant. |
| subMerchantRegisteredIdentifier - Parceiros: Não devem utilizar - Subadquirentes: Obrigatório | String | Identificador registrado do estabelecimento sub-merchant. |
| subMerchantLegalName - Parceiros: Não devem utilizar - Subadquirentes: Obrigatório | String | Razão social do sub-merchant. Atributo obrigatório para aplicações de subadquirentes. NÃO é a informação que aparece na fatura do portador. Veja o campo shortName. |
| subMerchantBuildingNumber - Parceiros: Não devem utilizar - Subadquirentes: Obrigatório | String | Número do prédio do estabelecimento sub-merchant. |
| subMerchantCountryCode - Parceiros: Não devem utilizar - Subadquirentes: Obrigatório | String | Código do país do estabelecimento sub-merchant (ex: 076 para Brasil). |
| subMerchantState - Parceiros: Não devem utilizar - Subadquirentes: Obrigatório | String | UF do estado do estabelecimento sub-merchant. |
| subMerchantNeighborhood - Parceiros: Não devem utilizar - Subadquirentes: Obrigatório | String | Bairro do estabelecimento sub-merchant. |
| subMerchantEmail - Parceiros: Não devem utilizar - Subadquirentes: Obrigatório | String | Email de contato do estabelecimento sub-merchant. |
| subMerchantPhone - Parceiros: Não devem utilizar - Subadquirentes: Obrigatório | String | Telefone de contato do estabelecimento sub-merchant. |
| subMerchantTaxIdentificationType - Parceiros: Não devem utilizar - Subadquirentes: Obrigatório | String | Tipo de documento fiscal do estabelecimento sub-merchant (ex: CNPJ, CPF). |
| subMerchantSiteUrl - Parceiros: Não devem utilizar - Subadquirentes: Obrigatório | String | URL do site do estabelecimento sub-merchant. |
| subMerchantPaymentGatewayId - Parceiros: Não devem utilizar - Subadquirentes: Obrigatório | String | ID do gateway de pagamento do estabelecimento sub-merchant. |
| external_id | String | Campo restrito para POS Android Stone. |
| transaction_qualifier | String | Qualificador da transação, como Prepaid, para indicar cartão pré-pago. |
📘 Nota: Os campos de sub-merchant são opcionais, porém em caso de sub-adquirente a passagem desses campos é obrigatória.