---
updatedAt: 2026-04-06T17:31:42.000Z
agentTools:
  projectIndex: https://docs.pagar.me/v4/llms.txt
---

# Objeto transaction (transação)

> ❗️ Você está na versão correta da documentação?
>
> Verifique na sua [Dashboard](https://dashboard.pagar.me/#/myaccount/apikeys) a versão da API que você está usando. Você deve usar a documentação correspondente. Para saber mais, veja: [Versionamento](https://docs.pagar.me/v3/docs/versionamento).

Ao criar ou atualizar uma transação, este é o objeto que você recebe como resposta em cada etapa do processo de efetivação da transação.

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        Propriedade
      </th>

      <th>
        Descrição
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        **object**
        `String`
      </td>

      <td>
        Nome do tipo do objeto criado/modificado.  

        * \*Valor retornado\*\*: `transaction`
      </td>
    </tr>

    <tr>
      <td>
        **status**\
        `String`
      </td>

      <td>
        Representa o estado da transação. A cada atualização no processamento da transação, esta propriedade é alterada e, caso você esteja usando uma `postback_url`, os seus servidores são notificados desses updates.\
        Valores possíveis: `processing`, `authorized`, `paid`, `refunded`, `waiting_payment`, `pending_refund`, `refused`, `chargedback`
      </td>
    </tr>

    <tr>
      <td>
        **refuse\_reason**\
        `String`
      </td>

      <td>
        Motivo pelo qual a transação foi recusada.\
        Valores possíveis: `acquirer`, `antifraud`, `internal_error`, `no_acquirer`, `acquirer_timeout`
      </td>
    </tr>

    <tr>
      <td>
        **status\_reason**\
        `String`
      </td>

      <td>
        Agente responsável pela validação ou anulação da transação.\
        Valores possíveis: `acquirer`, `antifraud`, `internal_error`, `no_acquirer`, `acquirer_timeout`
      </td>
    </tr>

    <tr>
      <td>
        **acquirer\_name**\
        `String`
      </td>

      <td>
        Adquirente responsável pelo processamento da transação.\
        Valores possíveis: `development` (em ambiente de testes), `pagarme` (adquirente Pagar.me), `stone`, `cielo`, `rede`.
      </td>
    </tr>

    <tr>
      <td>
        **acquirer\_id**\
        `String`
      </td>

      <td>
        ID da adquirente responsável pelo processamento da transação.
      </td>
    </tr>

    <tr>
      <td>
        **acquirer\_response\_code**\
        `String`
      </td>

      <td>
        Mensagem de resposta da adquirente referente ao status da transação.
      </td>
    </tr>

    <tr>
      <td>
        **authorization\_code**\
        `String`
      </td>

      <td>
        Código de autorização retornado pela bandeira.
      </td>
    </tr>

    <tr>
      <td>
        **soft\_descriptor**\
        `String`
      </td>

      <td>
        Texto que irá aparecer na fatura do cliente depois do nome da loja.  

        * \*OBS\*\*: Limite de 13 caracteres.
      </td>
    </tr>

    <tr>
      <td>
        **tid**\
        `String`
      </td>

      <td>
        Código que identifica a transação na adquirente.
      </td>
    </tr>

    <tr>
      <td>
        **nsu**\
        `String`
      </td>

      <td>
        Código que identifica a transação na adquirente.
      </td>
    </tr>

    <tr>
      <td>
        **date\_created**\
        `String`
      </td>

      <td>
        Data de criação da transação no formato `ISODate`
      </td>
    </tr>

    <tr>
      <td>
        **date\_updated**\
        `String`
      </td>

      <td>
        Data de atualização da transação no formato `ISODate`
      </td>
    </tr>

    <tr>
      <td>
        **amount**\
        `Integer`
      </td>

      <td>
        Valor, em centavos, da transação.  

        * \*Exemplo\*\*: `R$100,00 = 10000`
      </td>
    </tr>

    <tr>
      <td>
        **authorized\_amount**\
        `Integer`
      </td>

      <td>
        Valor em centavos autorizado na transação, sempre menor ou igual a `amount`.
      </td>
    </tr>

    <tr>
      <td>
        **paid\_amount**\
        `Integer`
      </td>

      <td>
        Valor em centavos capturado na transação, sempre menor ou igual a `authorized_amount`.
      </td>
    </tr>

    <tr>
      <td>
        **refunded\_amount**\
        `Integer`
      </td>

      <td>
        Valor em centavos estornado até o momento na transação, sempre menor ou igual a `paidamount`
      </td>
    </tr>

    <tr>
      <td>
        **installments**\
        `Integer`
      </td>

      <td>
        Número de parcelas a serem cobradas.\
        **OBS: Mínimo 1 e Máximo 12.**
      </td>
    </tr>

    <tr>
      <td>
        **id**\
        `Numeric`
      </td>

      <td>
        Número identificador da transação
      </td>
    </tr>

    <tr>
      <td>
        **cost**\
        `Integer`
      </td>

      <td>
        Custo da transação para o lojista, envolvendo processamento e antifraude.
      </td>
    </tr>

    <tr>
      <td>
        **card\_holder\_name**\
        `String`
      </td>

      <td>
        Nome do portador do cartão.
      </td>
    </tr>

    <tr>
      <td>
        **card\_last\_digits**\
        `String`
      </td>

      <td>
        Últimos 4 dígitos do cartão.
      </td>
    </tr>

    <tr>
      <td>
        **card\_first\_digits**\
        `String`
      </td>

      <td>
        Primeiros 5 dígitos do cartão
      </td>
    </tr>

    <tr>
      <td>
        **card\_brand**\
        `String`
      </td>

      <td>
        Bandeira do cartão.
      </td>
    </tr>

    <tr>
      <td>
        **card\_pin\_mode**\
        `String`
      </td>

      <td>
        Usado em transações EMV, define se a validação do cartão aconteceu online(com banco emissor), ou offline( através do chip).
      </td>
    </tr>

    <tr>
      <td>
        **postback\_url**\
        `String`
      </td>

      <td>
        URL (endpoint) de seu sistema que recebe notificações a cada mudança no status da transação.
      </td>
    </tr>

    <tr>
      <td>
        **payment\_method**\
        `String`
      </td>

      <td>
        Método de pagamento, com os possíveis valores: `credit_card`, `boleto` e `pix`.
      </td>
    </tr>

    <tr>
      <td>
        **capture\_method**\
        `String`
      </td>

      <td>
        Define qual foi a forma de captura dos dados de pagamento. Valores possíveis: magstripe, emv, ecommerce.
      </td>
    </tr>

    <tr>
      <td>
        **antifraud\_score**\
        `String`
      </td>

      <td>
        Define qual foi a nota de antifraude atribuída a transação. Lembrando que por padrão, transações com `score >= 95` são recusadas.
      </td>
    </tr>

    <tr>
      <td>
        **boleto\_url**\
        `String`
      </td>

      <td>
        URL do boleto para impressão
      </td>
    </tr>

    <tr>
      <td>
        **boleto\_barcode**\
        `String`
      </td>

      <td>
        Código de barras do boleto gerado na transação
      </td>
    </tr>

    <tr>
      <td>
        **boleto\_expiration\_date**\
        `String`
      </td>

      <td>
        Data de expiração do boleto (em ISODate)
      </td>
    </tr>

    <tr>
      <td>
        **referer**\
        `String`
      </td>

      <td>
        Mostra se a transação foi criada utilizando a API Key ou Encryption Key
      </td>
    </tr>

    <tr>
      <td>
        **ip**\
        `String`
      </td>

      <td>
        IP de origem que criou a transação, podendo ser diretamente de seu cliente, caso a requisição venha diretamente do client-side, ou de seus servidores, caso tudo esteja centralizando em sua aplicação no server-side.
      </td>
    </tr>

    <tr>
      <td>
        **subscription\_id**\
        `Integer`
      </td>

      <td>
        Caso essa transação tenha sido originada na cobrança de uma assinatura, o `id` desta será o valor dessa propriedade.
      </td>
    </tr>

    <tr>
      <td>
        **customer**\
        `Object`
      </td>

      <td>
        Dados do cliente. Obrigatório com o antifraude habilitado. O objeto`customer` é descrito [aqui](https://docs.pagar.me/v3/reference#criando-um-cliente)
      </td>
    </tr>

    <tr>
      <td>
        **billing**\
        `Object`
      </td>

      <td>
        Dados de cobrança da transação. Obrigatório com o antifraude habilitado. O objeto`billing` é descrito [aqui](https://docs.pagar.me/v3/reference#objeto-billing-dados-de-cobrança)
      </td>
    </tr>

    <tr>
      <td>
        **shipping**\
        `Object`
      </td>

      <td>
        Dados de envio do que foi comprado. Deve ser preenchido no caso de venda de bem físico. O objeto`shipping` é descrito [aqui](https://docs.pagar.me/v3/reference#objeto-shipping-dados-de-envio)
      </td>
    </tr>

    <tr>
      <td>
        **items**\
        `Object`
      </td>

      <td>
        Dados sobre os produtos comprados. Obrigatório com o antifraude habilitado. O objeto`items` é descrito [aqui](https://docs.pagar.me/v3/reference#objeto-items-itens)
      </td>
    </tr>

    <tr>
      <td>
        **address**\
        `Object`
      </td>

      <td>
        Dados de endereço, presente em `shipping` e `billing`. Obrigatório com o antifraude habilitado. O objeto`address` é descrito [aqui](https://docs.pagar.me/v3/reference#objeto-address-endereço)
      </td>
    </tr>

    <tr>
      <td>
        **documents**\
        `Array of objects`
      </td>

      <td>
        Informações de documentos do comprador. Obrigatório com o antifraude habilitado. O objeto`documents` é descrito [aqui](https://docs.pagar.me/v3/reference#objeto-documents-documentos)
      </td>
    </tr>

    <tr>
      <td>
        **metadata**\
        `Object`
      </td>

      <td>
        Objeto com dados adicionais informados na criação da transação.
      </td>
    </tr>

    <tr>
      <td>
        **split\_rules**\
        `Object`
      </td>

      <td>
        Objeto com as regras de split definidas para essa transação.
      </td>
    </tr>

    <tr>
      <td>
        **antifraud\_metadata**\
        `Object`
      </td>

      <td>
        Objeto com dados usados na integração com antifraude.
      </td>
    </tr>

    <tr>
      <td>
        **session**\
        `String`
      </td>

      <td>
        Valor único que identifica a sessão do usuário acessando o site
      </td>
    </tr>

    <tr>
      <td>
        **reference\_key**\
        `String`
      </td>

      <td>
        Valor único que identifica a transação para permitir uma nova tentativa de requisição com a segurança de que a mesma operação não será executada duas vezes acidentalmente.
      </td>
    </tr>

    <tr>
      <td>
        **card\_funding\_source**\
        `String`
      </td>

      <td>
        Indica modelo de liquidação que será adotado a depender do cartão utilizado no processamento da transação, com os possíveis valores: `credit` (Cartão de Crédito), `debit` (Cartão de Débito), e `prepaid` (Cartão Pré Pago)
      </td>
    </tr>

    <tr>
      <td>
        **initiated\_type**\
        `String`
      </td>

      <td>
        Identificador do tipo de transação avulsa.\
        Valores possíveis: PartialShipment (Remessa Parcial), RelatedOrDelayedCharge (Cobrança Atrasada), NoShow (Multa) ou Retry (Retentativa).
      </td>
    </tr>

    <tr>
      <td>
        **recurrence\_model**\
        `String`
      </td>

      <td>
        Identificador do tipo de recorrência.\
        Valores possíveis: standing\_order (Ordem Permanente) ou installment (Parcelamento).
      </td>
    </tr>
  </tbody>
</Table>

Segue abaixo um exemplo de objeto de resposta.

```json
{
    "object": "transaction",
    "status": "paid",
    "refuse_reason": null,
    "status_reason": "acquirer",
    "acquirer_response_code": "0000",
    "acquirer_name": "pagarme",
    "acquirer_id": "5969170917bce0470c8bf099",
    "authorization_code": "65208",
    "soft_descriptor": null,
    "tid": 1830855,
    "nsu": 1830855,
    "date_created": "2017-08-14T20:35:46.046Z",
    "date_updated": "2017-08-14T20:35:46.455Z",
    "amount": 10000,
    "authorized_amount": 10000,
    "paid_amount": 10000,
    "refunded_amount": 0,
    "installments": 1,
    "id": 1830855,
    "cost": 50,
    "card_holder_name": "Morpheus Fishburne",
    "card_last_digits": "1111",
    "card_first_digits": "411111",
    "card_brand": "visa",
    "card_pin_mode": null,
    "card_funding_source": "credit",
    "postback_url": null,
    "payment_method": "credit_card",
    "capture_method": "ecommerce",
    "antifraud_score": null,
    "boleto_url": null,
    "boleto_barcode": null,
    "boleto_expiration_date": null,
    "referer": "api_key",
    "ip": "10.2.11.17",
    "subscription_id": null,
    "phone": null,
    "address": null,
    "customer": {
        "object": "customer",
        "id": 233238,
        "external_id": "#3311",
        "type": "individual",
        "country": "br",
        "document_number": null,
        "document_type": "cpf",
        "name": "Morpheus Fishburne",
        "email": "mopheus@nabucodonozor.com",
        "phone_numbers": [
            "+5511999998888",
            "+5511888889999"
        ],
        "born_at": null,
        "birthday": "1965-01-01",
        "gender": null,
        "date_created": "2017-08-14T20:35:45.963Z",
        "documents": [
            {
                "object": "document",
                "id": "doc_cj6cmcm2l01z5696dyamemdnf",
                "type": "cpf",
                "number": "00000000000"
            }
        ]
    },
    "billing": {
        "address": {
            "object": "address",
            "street": "Rua Matrix",
            "complementary": null,
            "street_number": "9999",
            "neighborhood": "Rio Cotia",
            "city": "Cotia",
            "state": "sp",
            "zipcode": "06714360",
            "country": "br",
            "id": 145818
        },
        "object": "billing",
        "id": 30,
        "name": "Trinity Moss"
    },
    "shipping": {
        "address": {
            "object": "address",
            "street": "Rua Matrix",
            "complementary": null,
            "street_number": "9999",
            "neighborhood": "Rio Cotia",
            "city": "Cotia",
            "state": "sp",
            "zipcode": "06714360",
            "country": "br",
            "id": 145819
        },
        "object": "shipping",
        "id": 25,
        "name": "Neo Reeves",
        "fee": 1000,
        "delivery_date": "2000-12-21",
        "expedited": true
    },
    "items": [
        {
            "object": "item",
            "id": "r123",
            "title": "Red pill",
            "unit_price": 10000,
            "quantity": 1,
            "category": null,
            "tangible": true,
            "venue": null,
            "date": null
        },
        {
            "object": "item",
            "id": "b123",
            "title": "Blue pill",
            "unit_price": 10000,
            "quantity": 1,
            "category": null,
            "tangible": true,
            "venue": null,
            "date": null
        }
    ],
    "card": {
        "object": "card",
        "id": "card_cj6cmcm4301z6696dt3wypskk",
        "date_created": "2017-08-14T20:35:46.036Z",
        "date_updated": "2017-08-14T20:35:46.524Z",
        "brand": "visa",
        "holder_name": "Morpheus Fishburne",
        "first_digits": "411111",
        "last_digits": "1111",
        "country": "UNITED STATES",
        "fingerprint": "3ace8040fba3f5c3a0690ea7964ea87d97123437",
        "valid": true,
        "expiration_date": "0922"
    },
    "split_rules": null,
    "metadata": {},
    "antifraud_metadata": {},
    "reference_key": null
}
```