URL Expired

The URL for this request expired after 30 days.

transactionId

uuid

required

accept

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 retrieved successfully

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

card object

self

object

self object

subaccount

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 | null

required

The unique identifier of the card related to this entity. Null only for bank-sourced transactions on a bank account with no linked cards (the card-less unified feed); the _links.card link is omitted in that case.

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.

id

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.

supersededMessageIds

array of uuids

Message ids from _links.messages whose financial contribution was superseded during aggregation — typically duplicate deliveries of the same clearing across network feeds, or a provisional bank-sourced settlement replaced by the network clearing. Superseded messages stay listed in _links.messages for audit but do not count toward the settled amounts, so exclude them when deriving totals from individual messages (or better, use transactionSettledAmount / cardholderBillingSettledAmount directly). Always a subset of _links.messages. Each payload carries the full current set (a snapshot, not a delta). Transactions last updated before this field was introduced report [] until their next update.

status

string

enum

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 UTC date when the transaction took place, following ISO 8601 format (YYYY-MM-DD). This is a date-only field with no time component.

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 resource was created, in UTC, following ISO 8601 format.

updatedAt

date-time

required

Date and time when this resource was last updated, 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

ShellNodeRubyPHPPython

Bearer

``

xxxxxxxxxx

curl --request GET
--url https://api.astrada.co/transactions/transactionId
--header 'accept: application/hal+json' ``

xxxxxxxxxx

{
  "_links": {
    "card": {
      "href": "/cards/4d1ff59f-4286-4209-9662-92e174193562"
    },
    "subaccount": {
      "href": "/subaccounts/c6d5e036-361e-4773-a514-b9496cf2d2b5"
    },
    "self": {
      "href": "/transactions/8697df0c-9011-47ca-a52b-8d2a7a4ad903"
    },
    "messages": [
      {
        "href": "/transaction-messages/f4b24a0a-6a37-4ce3-8845-ddf0b604a9b4"
      },
      {
        "href": "/transaction-messages/934f8701-53e3-4a2b-a000-6bb52195d2ea"
      }
    ]
  },
  "acceptor": {
    "city": "LONDON",
    "country": "GBR",
    "mcc": "5734",
    "state": "LND"
  },
  "cardId": "4d1ff59f-4286-4209-9662-92e174193562",
  "cardholderBillingCurrency": "GBP",
  "cardholderBillingHoldAmount": 0,
  "cardholderBillingSettledAmount": 0.81,
  "createdAt": "2024-05-01T06:41:43.810Z",
  "descriptor": "Uber",
  "id": "8697df0c-9011-47ca-a52b-8d2a7a4ad903",
  "network": "MASTERCARD",
  "status": "SETTLED",
  "subaccountId": "c6d5e036-361e-4773-a514-b9496cf2d2b5",
  "supersededMessageIds": [],
  "transactionCurrency": "USD",
  "transactionHoldAmount": 0,
  "transactionOccurrenceDate": "2024-05-01",
  "transactionSettledAmount": 1,
  "updatedAt": "2024-05-02T08:41:43.810Z"
}

Updatedabout 2 months ago