> This page is for North America.

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

# Authorize

POST 

The `Authorize` event indicates that the user has successfully authorized the transaction with their bank.

Reference: https://trustly.ferndocs.com/api-reference/api/event-notifications/authorize

## Request

### Payload

- `createdAt` (string, optional) — The timestamp when the event was created, represented as a Unix timestamp in milliseconds.
- `eventId` (string, optional) — Unique identifier for the event.
- `eventType` (string, optional) — The type of event that triggered the webhook.
- `merchantId` (string, optional) — The unique identifier of the merchant.
- `message` (string, optional) — A message describing the event.
- `objectId` (string, optional) — Unique identifier for the object associated with the event, such as a transaction.
- `objectType` (string, optional) — The type of object associated with the event (e.g., Transaction).
- `paymentType` (string, optional) — Type of payment, denoted by a numeric code.
- `status` (string, optional) — Status code representing the current state of the transaction.
- `statusMessage` (string, optional) — A message describing the current status of the transaction.
- `timeZone` (string, optional) — The timezone of the event, formatted in IANA timezone database format.
- `transactionType` (string, optional) — Type of transaction, denoted by a numeric code.
- `splitToken` (string, optional) — Encrypted token generated during user authorization. Note, token may include url escape characters which must be encoded or the request will result in an error. See [Split Token](doc:reference-split-token) for more info.