Retrieve transaction

get https://api.astrada.co/transactions/{transactionId}

Returns a transaction by its unique identifier, including details about the transaction's state and relevant transactional data.

Responses

Response body

object

_links

object

required

messages

array of objects

required

messages*

object

href

string

required

templated

boolean

type

string

deprecation

string

name

string

profile

string

title

string

hreflang

string

card

object

self

object

subaccount

object

acceptor

object

required

The details relating to the acceptor (merchant) from the latest transaction message.

city

string | null

required

The acceptor's registered city. Defined by the acquirer/processor.

country

string | null

required

The acceptor's registered country following ISO 3166 alpha-3.

mcc

string | null

required

The Merchant Category Code provided by the acquirer/processor. Used to classify businesses by the types of goods provided or services rendered.

state

string | null

required

The acceptor's registered state (e.g. Michigan) as assigned by the acquirer/processor.

cardId

uuid

required

The unique identifier of the card related to this entity.

cardholderBillingCurrency

string

required

The currency of the country of issuance following ISO 4217 alpha-3 format.

cardholderBillingHoldAmount

double

required

This amount models the hold on the cardholder account, in the card's issued currency, that occurs after an authorization and before a financial message. This amount will change as both authorization and financial messages are added to the Transaction in order to reflect the remaining hold amount.

cardholderBillingSettledAmount

double

required

The settled amount models the bottom line impact to the customer's bank statement in the card's issued currency. This amount will change as financial messages are added to the Transaction.

descriptor

string | null

required

Cleansed merchant name.

uuid

required

The unique identifier of this transaction entity.

network

string

required

The card network that processed this payment.

subaccountId

uuid

required

The unique identifier of the subaccount related to this entity.

status

string

required

A semantic understanding of the state of the transaction within the transaction lifecycle. Learn More

PENDING VOIDED DECLINED SETTLED

transactionCurrency

string

required

The currency in which the transaction took place following ISO 4217 alpha-3 format.

transactionHoldAmount

double

required

This amount models the hold on the cardholder account, in the currency the transaction was conducted in, that occurs after an authorization and before a financial message. This amount will change as both authorization and financial messages are added to the Transaction in order to reflect the remaining hold amount.

transactionOccurrenceDate

date | null

required

The date when the transaction took place following ISO 8601 format.

transactionSettledAmount

double

required

The settled amount models the bottom line impact to the customer's bank statement in the currency the transaction was conducted in. This amount will change as financial messages are added to the Transaction.

createdAt

date-time

required

Date and Time when this entity was created following ISO 8601 format.

updatedAt

date-time

required

Date and Time when this entity was last updated following ISO 8601 format.

200Transaction retrieved successfully

400The server cannot or will not process the request due to something that is perceived to be a client error

401Authentication credentials were either missing or incorrect

403Authentication credentials used do not have have permissions to perform the request

404The requested resource was not found on the server

500The server encountered an unexpected condition that prevented it from fulfilling the request