Retrieve transaction message

Time	Status	User Agent
Make a request to see history.

URL Expired

The URL for this request expired after 30 days.

transactionMessageId

uuid

required

string

enum

Defaults to application/hal+json

Generated from available response content types

application/hal+jsonapplication/problem+json

Allowed:

application/hal+json``application/problem+json

``200 Transaction message retrieved successfully

object

_links

object

required

self

object

required

self object

raw

object

raw object

uuid

required

The unique identifier of this transaction message entity.

acceptor

object

required

The details relating to the acceptor (merchant) that initiated the transaction message.

acquirerId

string | null

required

The identifier of the acquirer/processor used by the acceptor as assigned by the network.

city

string | null

required

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

country

string | null

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

string | null

required

The identifier of the payment acceptor (merchant) as assigned by the acquirer/processor.

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.

name

string | null

required

The acceptor (merchant) name.

state

string | null

required

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

approvalCode

string | null

Unique code that authorizes a transaction message, sent by the card issuer/issuer-processor when approving a transaction. Always absent on bank-only messages — no card authorization occurred (its absence, together with the bank_-prefixed transactionReference, is the marker of a bank-only message).

bankData

object | null

Bank-side provenance, present only on bank-sourced messages (null otherwise). Deliberately slim — the bank's merchant string, dates and amounts map into the canonical fields above; bankTransactionId is the stable join key back to the bank feed. It equals banktransaction.created.id and transaction.match.created.matches[].id, and resolves via GET /bank-transactions/{id} for the full bank record.

provider

string

enum required

Open banking provider that observed the bank transaction.

plaid

bankTransactionId

uuid

required

The bank transaction entity id — the canonical, lifecycle-stable join key across every bank-data surface.

personalFinanceCategory

object | null

Provider categorization of the bank transaction — the one bank-only datum with no card-side equivalent.

personalFinanceCategory object | null

cardId

uuid | null

required

The unique identifier of the card related to this entity. Null only for bank-sourced messages from a bank account with no linked cards (the card-less unified feed).

cardType

string

The type of card used in the transaction. The only available value is 'virtual' and the field is nullable.

cardholderBillingAmount

number

required

The amount in the currency of the country of issuance. The transactionAmount and cardholderBillingAmount values may differ in case of international transactions.

cardholderBillingCurrency

string

required

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

createdDateTime

date-time

required

Date and time when this resource was created, in UTC, following ISO 8601 format.

dateTime

date-time

required

The timestamp of the transaction message (e.g. authorization, movement of funds, etc) following ISO 8601 format. The timezone depends on the card network:

Visa/Amex: UTC (suffixed with Z)
Mastercard: Local time zone of the merchant/acquirer (no Z suffix, timezone offset not included)

The presence or absence of the Z suffix indicates whether the value is UTC or local time.

messageType

string

enum required

The type of operation this transaction message represents. Learn More

AUTH_ADVC``AUTH_REQU``FINL_ADVC``CBCK_ADVC``FINL_REQU

network

string

enum required

The rail that processed this payment. OPEN_BANKING marks a bank-sourced message with no card-network involvement (the concrete provider is in bankData.provider).

VISA``MASTERCARD``AMEX``OPEN_BANKING

subaccountId

uuid

required

The unique identifier of the subaccount related to this entity.

result

string

enum required

The issuer's decision on whether the transaction message is authorized.

APPROVED``DECLINED

transactionAmount

number

required

The amount of the transaction message in the currency it was charged in. In the case of international transactions, the transactionAmount and cardholderBillingAmount may differ due to being in different currencies.

transactionCurrency

string

required

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

transactionReference

string

required

Identification of the Transaction that has to be unique for a time period.

transactionType

string | null

enum required

Types provide additional information about the transaction message, describing the effect that it had on the customer account and the type of accounts affected. Learn More

DEBIT_01``DEBIT_02``DEBIT_19``CREDIT_01``CREDIT_02``INQUIRY_01``TRANSFER_01``ADMIN_01``ADMIN_02

transmissionDateTime

date-time | null

required

The timestamp of when the transaction message was received by the data source (i.e. Mastercard or Visa), in UTC, following ISO 8601 format.

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

``401 Authentication credentials were either missing or incorrect

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

``404 The requested resource was not found on the server

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

Updated about 2 months ago

What’s Next

Learn more about Transaction message fields

Transaction Message

Did this page help you?

Yes

ShellNodeRubyPHPPython

Bearer


xxxxxxxxxx

curl --request GET \

--url https://api.astrada.co/transaction-messages/transactionMessageId \

--header 'accept: application/hal+json'


xxxxxxxxxx

{

"_links": {

"self": {

"href": "/transaction-messages/80b08eeb-c4cc-4e5c-8d0b-15bc2e04b4dc"

},

"raw": {

"href": "/transaction-messages/80b08eeb-c4cc-4e5c-8d0b-15bc2e04b4dc/raw"

}

},

"acceptor": {

"acquirerId": null,

"city": "LONDON",

"country": "GBR",

"id": "KWGBYTEI4FL0QQQ",

"mcc": "5734",

"name": "Uber",

"state": "LND"

},

"accountId": "a49fdf13-62ce-4704-80bf-82f317cc215e",

"approvalCode": "537254",

"bankData": null,

"cardId": "bf4d1e23-0f5a-42a7-81f2-bc66f392a98c",

"cardType": "virtual",

"cardholderBillingAmount": 1.18,

"cardholderBillingCurrency": "GBP",

"createdDateTime": "2024-04-26T01:41:22.544Z",

"dateTime": "2024-04-24T13:39:45Z",

"id": "80b08eeb-c4cc-4e5c-8d0b-15bc2e04b4dc",

"messageType": "FINL_ADVC",

"network": "MASTERCARD",

"result": "APPROVED",

"subaccountId": "cb4d801e-a10a-4f42-b9de-1c51685ffd8a",

"transactionAmount": 1.45,

"transactionCurrency": "USD",

"transactionReference": "IWVQ22_2024-04-24",

"transactionType": "DEBIT_01",

"transmissionDateTime": "2024-04-25T00:00:00.000Z"

}