> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://amer.developers.trustly.com/llms.txt.
> For full documentation content, see https://amer.developers.trustly.com/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://amer.developers.trustly.com/_mcp/server.

# Establish

POST 

TThe `Establish` event indicates that a new transaction has been created. This occurs when a user activates the Trustly User Interface (UI) or when you create a transaction using the API

Reference: https://amer.developers.trustly.com/api-reference/api/event-notifications/establish

## OpenAPI 3.1 Webhook Specification

```yaml
openapi: 3.1.0
info:
  title: Trustly API
  version: 1.0.0
paths: {}
webhooks:
  establish:
    post:
      operationId: establish
      summary: Establish
      description: >-
        TThe `Establish` event indicates that a new transaction has been
        created. This occurs when a user activates the Trustly User Interface
        (UI) or when you create a transaction using the API
      responses:
        '200':
          description: Webhook received successfully
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EventEstablish'
components:
  schemas:
    EventEstablishPaymentProviderTransaction:
      type: object
      properties:
        status:
          type: string
        statusMessage:
          type: string
      title: EventEstablishPaymentProviderTransaction
    EventEstablish:
      type: object
      properties:
        createdAt:
          type: string
          format: int64
          description: >-
            The timestamp when the event was created, represented as a Unix
            timestamp in milliseconds.
        eventId:
          type: string
          description: Unique identifier for the event.
        eventType:
          type: string
          description: The type of event that triggered the webhook.
        merchantId:
          type: string
          description: The unique identifier of the merchant.
        message:
          type: string
          description: A message describing the event.
        objectId:
          type: string
          description: >-
            Unique identifier for the object associated with the event, such as
            a transaction.
        objectType:
          type: string
          description: The type of object associated with the event (e.g., Transaction).
        paymentType:
          type: string
          description: Type of payment, denoted by a numeric code.
        status:
          type: string
          description: Status code representing the current state of the transaction.
        statusMessage:
          type: string
          description: A message describing the current status of the transaction.
        timeZone:
          type: string
          description: >-
            The timezone of the event, formatted in IANA timezone database
            format.
        transactionType:
          type: string
          description: Type of transaction, denoted by a numeric code.
        merchantReference:
          type: string
        paymentProviderTransaction:
          $ref: '#/components/schemas/EventEstablishPaymentProviderTransaction'
      description: >-
        The 'Establish' event is triggered when a new transaction has been
        created. This event may occur when a user activates the Trustly UI or
        when a transaction is created via an API call.
      title: EventEstablish

```