---
title: "TransactionObject"
url: "https://devcenter.stone.com.br/sdk-android-transactionobject"
image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_TransactionObject,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9zZGstYW5kcm9pZC10cmFuc2FjdGlvbm9iamVjdCI,s__zN1YvcLYvsOz2Zr.png"
---

# TransactionObject

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.                                           |
| qualifiers                                                                       | Set<String>               | Qualificadores de uma 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.

---

**Jornada: [Apêndice: objetos, status e códigos](https://devcenter.stone.com.br/sdk-android-app-qrcodepay-pix-debug)**  
Etapa 8 de 17

[**Etapa anterior**TransactionDAO](https://devcenter.stone.com.br/sdk-android-transaction-dao)[**Próxima etapa**Transaction Enums](https://devcenter.stone.com.br/sdk-android-transaction-enums)

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.