Sign in
Transactions

Get a transaction

Versions 1 and 2 of the Transfers API are deprecated. If you are just starting your implementation, use the latest version.

Returns a transaction.

get/transactions/{id}

Path parameters

idstring required

The unique identifier of the transaction.

Response

OK - the request has succeeded.

accountHolderIdstring required

Unique identifier of the account holder.

balanceAccountIdstring required

Unique identifier of the balance account.

balancePlatformstring required

The unique identifier of the balance platform.

bookingDatestring date-time required

The date the transaction was booked into the balance account.

category'bank' | 'card' | 'grants' | 'interest' | 'internal' | 'issuedCard' | 'migration' | 'platformPayment' | 'topUp' | 'upgrade'

The category of the transaction indicating the type of activity.

Possible values:

  • platformPayment: The transaction is a payment or payment modification made with an Adyen merchant account.

  • internal: The transaction resulted from an internal adjustment such as a deposit correction or invoice deduction.

  • bank: The transaction is a bank-related activity, such as sending a payout or receiving funds.

  • issuedCard: The transaction is a card-related activity, such as using an Adyen-issued card to pay online.

createdAtstring date-time required

The date the transaction was created.

creationDatestring date-time

The date and time when the event was triggered, in ISO 8601 extended format. For example, 2025-03-19T10:15:30+01:00.

descriptionstring

The description from the /transfers request.

eventIdstring

The PSP reference of the transaction in the journal.

idstring required

The unique identifier of the transaction.

paymentInstrumentIdstring

The unique identifier of the payment instrument that was used for the transaction.

referencestring required

The reference from the /transfers request. If you haven't provided any, Adyen generates a unique reference.

referenceForBeneficiarystring

The reference sent to or received from the counterparty.

status'booked' | 'pending' required

The status of the transaction.

Possible values:

  • pending: The transaction is still pending.

  • booked: The transaction has been booked to the balance account.

transferIdstring

Unique identifier of the related transfer.

type'atmWithdrawal' | 'atmWithdrawalReversal' | 'balanceAdjustment' | 'balanceMigration' | 'balanceRollover' | 'bankDirectDebit' | 'bankTransfer' | 'capitalFundsCollection' | 'capture' | 'captureReversal' | 'cardTransfer' | 'cashOutFee' | 'cashOutFunding' | 'cashOutInstruction' | 'cashoutFee' | 'cashoutFunding' | 'cashoutRepayment' | 'chargeback' | 'chargebackCorrection' | 'chargebackReversal' | 'chargebackReversalCorrection' | 'depositCorrection' | 'fee' | 'fxBuy' | 'fxSell' | 'grant' | 'installment' | 'installmentReversal' | 'interestPayout' | 'internalDirectDebit' | 'internalTransfer' | 'invoiceDeduction' | 'leftover' | 'manualCorrection' | 'miscCost' | 'payment' | 'paymentCost' | 'refund' | 'refundReversal' | 'repayment' | 'reserveAdjustment' | 'secondChargeback' | 'secondChargebackCorrection' | 'subsidization'

The type of the transaction.

Possible values: payment, capture, captureReversal, refund refundReversal, chargeback, chargebackReversal, secondChargeback, atmWithdrawal, atmWithdrawalReversal, internalTransfer, manualCorrection, invoiceDeduction, depositCorrection, bankTransfer, miscCost, paymentCost, fee

valueDatestring date-time required

The date the transfer amount becomes available in the balance account.

Changes

Changed in 20 of the 51 revisions of this API.134933

  • v359603902985d2See the full diff
    • ●

      added the new fxBuy enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new fxSell enum value to the response property for the response status

      response-property-enum-value-added

  • v3e124e4fc0aa31See the full diff
    • ○

      added discriminator to // response property for the response status

      response-property-discriminator-added

  • v32188d062ff1b4See the full diff
    • ▲

      the / response property's maxLength was unset from 3 for the response status

      response-property-max-length-unset

    • ▲

      the / response property's maxLength was unset from 3 for the response status

      response-property-max-length-unset

    • ▲

      the / response property's minLength was decreased from 3 to 0 for the response status

      response-property-min-length-decreased

    • ▲

      the / response property's minLength was decreased from 3 to 0 for the response status

      response-property-min-length-decreased

  • v3215760574f4511See the full diff
    • ●

      added the new subsidization enum value to the response property for the response status

      response-property-enum-value-added

    • ○

      added the optional property /////// to the response with the status

      response-optional-property-added

  • v314eeca298eb11See the full diff
    • ○

      added the optional property // to the response with the status

      response-optional-property-added

  • v3e805ba875d261See the full diff
    • ▲

      the /////// response property's maxLength was increased from 15 to 17 for the response status

      response-property-max-length-increased

  • v3d1dbdbeb28e14See the full diff
    • ○

      added the optional property /// to the response with the status

      response-optional-property-added

    • ○

      added the optional property /// to the response with the status

      response-optional-property-added

    • ○

      added the optional property /// to the response with the status

      response-optional-property-added

    • ○

      added the optional property /// to the response with the status

      response-optional-property-added

  • v35045523564fd2See the full diff
    • ●

      added the new auBsbCode enum value to the //////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new caRoutingNumber enum value to the //////// response property for the response status

      response-property-enum-value-added

  • v325e7e713daa52See the full diff
    • ●

      added the new interest enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new interestPayout enum value to the response property for the response status

      response-property-enum-value-added

  • v3ebb1e0fcae2e11See the full diff
    • ▲

      the response property /// became optional for the status

      response-property-became-optional

    • ○

      added the optional property / to the response with the status

      response-optional-property-added