Core concepts

Foundational components, data models, and security patterns that power Trustly integrations.
View as Markdown

Before building your integration, familiarize yourself with the core building blocks — from the establishData object that configures every transaction to the webhook events that drive your backend logic.

The basics

Key concepts

The A2A payment model, Trustly Lightbox, and transaction lifecycle.

The establishData object

Configure merchant credentials, transaction details, and customer data.

Frontend and UX

Frontend integration

Understand the client-server boundary, request signatures, and transaction handoff.

Redirect URLs

Configure return and cancel URLs for user redirects.

Content strings

Trustly-provided UI strings for product names and messaging.

Backend and security

Transactions and transaction IDs

How transaction IDs track authorizations and payment events.

Webhooks and events

Receive asynchronous transaction status updates.

Tokens and account security

Tokenized bank account information and stored credential security.