Transactions

Get transaction by ID

Changed on

Returns a single transaction.

get/api/transactions/{id}

Request

  • Base URL: http://localhost:4100
  • URL: http://localhost:4100/api/transactions/{id}
  • Auth: none required

Path parameters

idstring uuid required

Transaction ID

Response

Transaction

account_holder_idstring uuid required
amountinteger required

Amount in minor currency units (cents) — always positive

compliance_screening_idstring uuid nullable

ComplianceScreening result for this transaction (auth:018 / camt:998)

creditor_counterparty_idstring uuid nullable

Creditor (payee) counterparty — pain:001 <Cdtr>

creditor_payment_account_idstring uuid nullable

Creditor (payee) payment account — pain:001 <CdtrAcct>

currencystring required

ISO 4217 3-letter currency code (e.g. USD, EUR, GBP)

debtor_counterparty_idstring uuid nullable

Debtor (payer) counterparty — pain:001 <Dbtr>

debtor_payment_account_idstring uuid nullable

Debtor (payer) payment account — pain:001 <DbtrAcct>

end_to_end_idstring nullable

pain:001 EndToEndId — set by originating party, immutable once set

external_idstring nullable

Caller-supplied SoE upsert key (unique per tenant when set)

idstring uuid
inserted_atstring date-time
instruction_idstring nullable

pain:001 TxId — instruction ID from the payment initiation message

ledger_entry_idstring uuid nullable

LedgerEntry created by this transaction (camt:052/053 Ntry)

rejected_codestring nullable

e.g. LIMIT_EXCEEDED.

rejected_direction'debit' | 'credit' nullable
rejected_ledger_account_idstring uuid nullable

LedgerAccount whose control limit was breached (NULL unless rejected).

rejected_period'daily' | 'weekly' | 'monthly' | 'yearly' nullable
rejected_rulestring nullable

Rule that set the breached cap.

requested_execution_datestring date nullable

Requested execution date (pain:001 ReqdExctnDt)

settlement_datestring date nullable

Actual settlement date (pacs:008 IntrBkSttlmDt / camt:054 BookgDt)

status'pending' | 'accepted' | 'settled' | 'rejected' | 'reversed' | 'cancelled' nullable

Payment lifecycle status (pain:002 / pacs:002 TxSts)

status_reason_codestring nullable

pacs:002 TxSts reason code (e.g. RJCT, ACCP, ACSC, PDNG)

tenant_idstring uuid required
transaction_numberstring

atomic-fi-generated internal handle

transaction_type'credit_transfer' | 'direct_debit' | 'card_payment' | 'refund' | 'reversal' | 'internal_transfer' required

ISO 20022 payment instruction type

uetrstring nullable

SWIFT gpi UETR (Unique End-to-End Transaction Reference — ISO 20022). Globally unique.

updated_atstring date-time

Example response

{
  "account_holder_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
  "amount": 0,
  "compliance_screening_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
  "creditor_counterparty_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
  "creditor_payment_account_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
  "currency": "",
  "debtor_counterparty_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
  "debtor_payment_account_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
  "end_to_end_id": "",
  "external_id": "",
  "id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
  "inserted_at": "2020-04-20T16:20:00Z",
  "instruction_id": "",
  "ledger_entry_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
  "rejected_code": "",
  "rejected_direction": "debit",
  "rejected_ledger_account_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
  "rejected_period": "daily",
  "rejected_rule": "",
  "requested_execution_date": "2020-04-20",
  "settlement_date": "2020-04-20",
  "status": "pending",
  "status_reason_code": "",
  "tenant_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
  "transaction_number": "",
  "transaction_type": "credit_transfer",
  "uetr": "",
  "updated_at": "2020-04-20T16:20:00Z"
}

Changes

  • e99ccd17df53Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 5105f6199e7dRevision changes
    • warning

      removed the optional property from the response with the status

    • info

      added the optional property to the response with the status