APG PayAPG Paydocs

Card issuer

Get issuer transaction

GET/issuer-transactions/{issuerTransactionId}
Request
GEThttps://api.tst.au.apgpay.dev/issuer-transactions/{issuerTransactionId}
curl -X GET https://api.tst.au.apgpay.dev/issuer-transactions/{issuerTransactionId} \
  -H "Authorization: Bearer $API_KEY"

Return one issuer transaction.

Permissions

Required permission
issuerTransactions:query

Requires the `query` action on `issuerTransactions` for the supplied runtime context

Path parameters

issuerTransactionIdstring
required

Responses

The response is a tagged shape: type is always "ItxnViewAttributes". Switch on it; subtypes can be added, and a client that already reads it will not break.

Discriminated by type
type = "ItxnViewAttributes"
issuerTransactionIdItxnIdrequired

Identifier of an issuer transaction.

Example itxn_9f2Kd8QpLzXw

statusItxnStatusrequired
AuthorisedCapturedRefundedPartiallyRefundedCancelledDisputedFailedUnknown
networkItxnNetworkrequired

Which scheme carried the authorisation.

UatpEmlUnknown

The card an issuer transaction was made against.

The amounts on an issuer transaction. All are in the single currency given here.

An amount in minor current units of a given currency.

The refunds issued against this transaction, in full. This is the only address an issuing refund has.

The disputes raised against this transaction, in full.

The merchant the card was presented to, as the scheme reported it.

descriptionstringrequired
loanIdLoanId

The loan the card draws against, where the card is backed by one.

Example loan_9f2Kd8QpLzXw

loanTransactionIdLtxnId

The loan movement this authorisation created, once it has one.

Example ltxn_9f2Kd8QpLzXw

settlementMerchantIdMchtIdrequired

The merchant the captured funds settle to.

Example mcht_9f2Kd8QpLzXw

referenceTransactionIdstring

Your own reference for this purchase. The natural key PATCH /issuer-transactions matches on.

Example your-own-reference

auditNumberstringrequired

The scheme's own trace number, UATP's system trace audit number, EML's logical transaction id.

approvalCodestring

The approval code, once the authorisation is approved.

metadatamap of any JSON value

Free-form data the platform stores against the transaction and returns untouched.

authorisedAtstring (date-time)required

Example 2026-08-19T04:21:07Z

capturedAtstring (date-time)

Example 2026-08-19T04:21:07Z

transactedAtstring (date-time)

When the card was actually presented, where the scheme reported it separately from the authorisation.

Example 2026-08-19T04:21:07Z

createdAtstring (date-time)required

Example 2026-08-19T04:21:07Z

updatedAtstring (date-time)required

Example 2026-08-19T04:21:07Z

Example
{
  "type": "ItxnViewAttributes",
  "issuerTransactionId": "itxn_9f2Kd8QpLzXw",
  "status": "Authorised",
  "network": "Uatp",
  "card": {
    "type": "ItxnCardAttributes",
    "cardId": "dcard_9f2Kd8QpLzXw",
    "cardReference": "your-own-reference",
    "last4": "4242",
    "bin": "424242",
    "brand": "Visa",
    "expiryMonth": 6,
    "expiryYear": 2029,
    "country": "AU",
    "cardHolderName": "Ada Lovelace"
  },
  "amounts": {
    "type": "ItxnAmountsAttributes",
    "currency": "AUD",
    "authorised": 1250,
    "captured": 1250,
    "refunded": 1250
  },
  "refundedBeforeConversion": {
    "type": "IsoCurrencyAmount",
    "minorCurrencyUnits": 1250,
    "currency": "AUD"
  },
  "refunds": [
    {
      "type": "ItxnRefundAttributes",
      "refundId": "rfnd_9f2Kd8QpLzXw",
      "referenceRefundId": "your-own-reference",
      "status": "Authorised",
      "amounts": {
        "type": "ItxnRefundAmountsAttributes",
        "currency": "AUD",
        "amount": 1250,
        "tax": 1250,
        "taxType": "string"
      },
      "taxRate": 0.9412,
      "originalAmount": {
        "type": "IsoCurrencyAmount",
        "minorCurrencyUnits": 1250,
        "currency": "AUD"
      },
      "metadata": {
        "yourKey": {}
      },
      "publishedMetadata": {
        "yourKey": {}
      },
      "customerStatementIssueDate": "2026-08-19",
      "processingDate": "2026-08-19",
      "publishedAt": "2026-08-19T04:21:07Z",
      "createdAt": "2026-08-19T04:21:07Z",
      "updatedAt": "2026-08-19T04:21:07Z"
    }
  ],
  "disputes": [
    {
      "type": "ItxnDisputeAttributes",
      "disputeId": "dispute_9f2Kd8QpLzXw",
      "referenceDisputeId": "your-own-reference",
      "outcome": "Pending",
      "amount": {
        "type": "IsoCurrencyAmount",
        "minorCurrencyUnits": 1250,
        "currency": "AUD"
      },
      "reason": "Requested by the customer.",
      "metadata": {
        "yourKey": {}
      },
      "createdAt": "2026-08-19T04:21:07Z",
      "updatedAt": "2026-08-19T04:21:07Z"
    }
  ],
  "acquiringMerchant": {
    "type": "ItxnAcquiringMerchantAttributes",
    "name": "Ada Lovelace",
    "merchantCategoryCode": "string",
    "iataNumber": "string",
    "taxId": "string",
    "country": "AU",
    "city": "string",
    "postCode": "3000",
    "emailAddress": "ada@example.com",
    "phoneNumber": "+61400000000"
  },
  "description": "string",
  "loanId": "loan_9f2Kd8QpLzXw",
  "loanTransactionId": "ltxn_9f2Kd8QpLzXw",
  "settlementMerchantId": "mcht_9f2Kd8QpLzXw",
  "referenceTransactionId": "your-own-reference",
  "auditNumber": "string",
  "approvalCode": "string",
  "metadata": {
    "yourKey": {}
  },
  "authorisedAt": "2026-08-19T04:21:07Z",
  "capturedAt": "2026-08-19T04:21:07Z",
  "transactedAt": "2026-08-19T04:21:07Z",
  "createdAt": "2026-08-19T04:21:07Z",
  "updatedAt": "2026-08-19T04:21:07Z"
}

Error responses