Consultado Status

GET /v1/transaction/{id}

Headers

Authorization

Token de usuário fornecido pela equipe GetCard.

Parâmetros de Rota

id

ID da transação que se deseja estornar.

Corpo da resposta

JSON

{
  "data": {
    "id": "3982c062-d156-43c5-a4c0-e7c037711f22",
    "terminalId": null,
    "status": "PAYMENT_PENDING",
    "message": null,
    "description": "Venda 123 do caixa 001",
    "amount": 5162,
    "paymentType": "DEBIT",
    "installmentType": "ONE_TIME",
    "installmentNumber": 1,
    "authorizationCode": null,
    "endToEndId": null,
    "nsuHost": null,
    "refundCode": null,
    "cardNumber": null,
    "cardBrand": null,
    "cardHolder": null,
    "createdAt": "2025-07-31T12:09:02.935Z",
    "authorizedAt": null,
    "refundedAt": null,
    "updatedAt": "2025-07-31T12:09:02.935Z"
  },
  "resultCode": 200,
  "message": "OK"
}

data — Object

Contém as informações da transação.

id — UUID

• Exemplo: "3982c062-d156-43c5-a4c0-e7c037711f22"
• Descrição: ID da transação consultada.

terminalId — String?

• Exemplo: "6369aed4-a26e-4ee9-8d58-474c4b610ca7"
• Descrição: ID do terminal vinculado à transação.

status — String

• Exemplo: "PAYMENT_PENDING"

• Possíveis valores:

  • "PAYMENT_PENDING"
  • "PAYMENT_PROCESSING"
  • "PAYMENT_TIMEOUT"
  • "PAYMENT_AUTHORIZED"
  • "PAYMENT_DECLINED"
  • "PAYMENT_FAILED"
  • "PAYMENT_CANCELLED"
  • "PAYMENT_UNKNOWN"
  • "REFUND_PENDING"
  • "REFUND_PROCESSING"
  • "REFUND_TIMEOUT"
  • "REFUND_AUTHORIZED"
  • "REFUND_DECLINED"
  • "REFUND_FAILED"
  • "REFUND_CANCELLED"
  • "REFUND_UNKNOWN"

• Descrição: Estado atual da transação.

description — String

• Exemplo: "Venda 123 do caixa 001"
• Descrição: Descrição personalizada da transação.

amount — Int

• Exemplo: 5162
• Descrição: Valor da transação em centavos. Ex: 5162 representa R$ 51,62.

paymentType — String

• Exemplo: "DEBIT"
• Valores possíveis:
  • "DEBIT"
  • "CREDIT"
  • "PIX"
• Descrição: Tipo de pagamento.

installmentType — String

• Exemplo: "ONE_TIME"
• Valores possíveis:
  • ONE_TIME
  • INSTALLMENT_SELLER
  • INSTALLMENT_BUYER
• Descrição: Tipo de parcelamento.

installmentNumber — Int

• Exemplo: 1
• Descrição: Número de parcelas.

authorizationCode — String?

• Exemplo: null
• Descrição: Código de autorização gerado pela adquirente, quando aplicável.

endToEndId — String?

• Exemplo: null
• Descrição: Identificador end-to-end para transações PIX.

nsuHost — String?

• Exemplo: null
• Descrição: NSU gerado pelo host/adquirente.

refundCode — String?

• Exemplo: null
• Descrição: Código de estorno, se aplicável.

cardNumber — String?

• Exemplo: "************1234" (quando presente)
• Descrição: Número mascarado do cartão utilizado.

cardBrand — String?

• Exemplo: "VISA"
• Descrição: Bandeira do cartão (ex: VISA, MASTERCARD).

cardHolder — String?

• Exemplo: "JOÃO SILVA"
• Descrição: Nome do portador do cartão, se disponível.

createdAt — String (ISO 8601)

• Exemplo: "2025-07-31T12:09:02.935Z"
• Descrição: Data/hora de criação da transação.

authorizedAt — String? (ISO 8601)

• Exemplo: null
• Descrição: Data/hora em que a transação foi autorizada, se aplicável.

refundedAt — String? (ISO 8601)

• Exemplo: null
• Descrição: Data/hora de estorno, se houver.

updatedAt — String (ISO 8601)

• Exemplo: "2025-07-31T12:09:02.935Z"
• Descrição: Data da última atualização da transação.

resultCode — Int

• Exemplo: 200
• Descrição: Código de status HTTP.

message — String

• Exemplo: "OK"
• Descrição: Descrição do resultado da operação.