For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dashboard
GuidesAPI ReferenceSDKs
GuidesAPI ReferenceSDKs
  • Get Started
    • Overview and Solutions
    • Choose an Integration
    • Quickstart
    • Branding Guidelines
    • Get Support
  • Accept Payments
    • Instant Payments
    • Trustly Pay
    • Recurring Payments
    • Scan and Pay
    • Remember Me
    • Payment Integration Checklist
  • Send Money
    • Send Payouts Using Online Banking
    • Send Payouts Using Account Information
    • International Transfers
  • Retrieve Data
    • Verify Accounts Using Online Banking
    • Verify Accounts Using Micro-Deposits
    • Retrieve Bank and User Information
    • Tokenize Bank Information
    • Trustly ID
    • Insights Data
  • Core Concepts
    • Key Concepts
    • The Establish Data Object
    • Transactions and Transaction IDs
    • Tokens and Account Security
    • Redirect URLs and Return Flow
    • Webhooks and Events
    • Content Strings
  • API Fundamentals
    • Authentication and OAuth
    • Secure Requests and Signature Validation
    • Idempotency
    • Testing
    • Status codes and type definitions
  • Manage Your Integration
    • Go-Live Checklist
    • Merchant Portal
    • Reports and Reconciliation
    • Refresh Bank Authorization
    • Override Risk Declines
    • VIP Tiers
    • Financial Institution Status
Dashboard
Products
PaymentsDataPayouts
Company
AboutCareersContact Sales

Terms of Use | Privacy Policy | © 2026 Trustly, Inc.

Developer-friendly docs for your API
GitHub|Contact Support|Business Help Center|Merchant Portal
Terms of Use|Privacy Policy|© 2026 Trustly, Inc.
Developer-friendly docs for your API
LogoLogo
North AmericaEurope
North AmericaEurope
On this page
  • Transaction ID usage
  • Transaction lifecycle examples
Core Concepts

Transaction ID

|View as Markdown|Open in Claude|
Was this page helpful?
Previous

Establish Data object

Next

Tokens and Account Security

Built with

The transactionId parameter is a unique identifier used throughout the Trustly API to track the lifecycle of an authorization or payment event. Understanding its role in various API calls is essential for correct integration.

Transaction ID usage

The transactionId is used to reference specific phases and events of a transaction:

  • Initial Authorization: When creating a bank authorization via the EstablishTransaction endpoint, a transactionId is generated. This ID specifically references the event of the consumer granting the mandate (consent) to use their account.
  • Fund Movement: Subsequent operations that move funds, such as a Capture or Deposit transaction, create a new transaction linked to the initial authorization. The output transactionId for these operations refers solely to the specific payment event (e.g., the debit or credit being processed).

When processing a Cancel Transaction call, use the transactionId associated with the specific fund movement (Capture or Deposit) transaction, not the original bank authorization ID. Canceling the bank authorization ID could result in a permanent cancellation of the consumer’s account mandate.

Transaction lifecycle examples

The table below illustrates which subsequent API actions can be performed using the transactionId generated by an initial action.

Initial Action (Generates)Subsequent Actions (Receives Reference)
Establish (Consent/Mandate)PreAuth (Authorization), Capture (Payin), Deposit (Payout), Cancel, User information, Account information
PreAuth (Authorization)Capture (Payin), Cancel
Capture (Payin)Cancel, Refund
Deposit (Payout)Cancel, Reclaim

Any transactionId can be used with the Get Transaction API endpoint to retrieve the latest status and details.