diff --git a/account/adding-safe-owner.mdx b/account/adding-safe-owner.mdx
deleted file mode 100644
index 49b5d5e..0000000
--- a/account/adding-safe-owner.mdx
+++ /dev/null
@@ -1,63 +0,0 @@
----
-title: "Managing Safe Ownership"
-description: "Add a new owner to a Gnosis Pay Safe Account"
----
-
-Adding a new owner to a Gnosis Pay Safe registers that account as a **Delay Module owner**.  
-Only Delay Module owners can approve and execute on-chain transactions.
-
-<Warning>
-**Important distinction:**  
-- **Authenticated wallets** are linked to a Gnosis Pay user for API access (via SIWE and JWT).  
-- **Safe owners (Delay Module owners)** are accounts explicitly added on-chain to the Safe.  
-Authenticated wallets do **not** become Safe owners unless they are also as owners for the safe.
-</Warning>
-
-This guide walks through the process of adding an additional Safe owner. Once complete, the new owner will be able to approve and execute transactions through the Delay Module.
-
-<Steps>
-  <Step title="Get a JWT token for the session">
-    Follow the [authentication flow](https://docs.gnosispay.com/auth) to obtain a JWT token for the Gnosis Pay user.
-  </Step>
-
-  <Step title="Get typed data for adding a new Safe owner">
-    Call [this endpoint](https://docs.gnosispay.com/api-reference/safe-owners/get-typed-data-for-adding-a-new-safe-owner) to receive the typed data.  
-    Sign the typed data with the current Safe owner’s key to produce a signature.
-
-    ```bash
-    curl --request GET \
-      --url https://api.gnosispay.com/api/v1/owners/add/transaction-data \
-      --header "Authorization: Bearer <token>"
-    ```
-  </Step>
-
-  <Step title="Submit the signature">
-    Send the new owner’s address, the signature, and the signed message to [this endpoint](https://docs.gnosispay.com/api-reference/safe-owners/add-a-new-owner-to-the-safe).
-
-    ```bash
-    curl --request POST \
-      --url https://api.gnosispay.com/api/v1/owners \
-      --header "Authorization: Bearer <token>" \
-      --header "Content-Type: application/json" \
-      --data '{
-        "newOwner": "0x3270bf32AB647e90eF94A026c70Aa1daaaDA2382",
-        "signature": "0x1234567890abcdef...",
-        "message": {
-          "salt": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
-          "data": "0xa9059cbb0000000000000000000000003270bf32ab647e90ef94a026c70aa1daaaada2382"
-        }
-      }'
-    ```
-    The operation is processed through the Delay Relay and executes after a 3-minute delay.
-  </Step>
-
-  <Step title="Verify ownership">
-    Confirm that the new owner was added to the Delay Module by checking the [Safe’s owner list](https://docs.gnosispay.com/api-reference/safe-owners/get-the-list-of-safe-owners).
-
-    ```bash
-    curl --request GET \
-      --url https://api.gnosispay.com/api/v1/owners \
-      --header "Authorization: Bearer <token>"
-    ```
-  </Step>
-</Steps>
diff --git a/account/index.mdx b/account/index.mdx
deleted file mode 100644
index 7bfb23d..0000000
--- a/account/index.mdx
+++ /dev/null
@@ -1,108 +0,0 @@
----
-title: "Accounts on Gnosis Pay"
-description: "How the Gnosis Pay Safe works"
----
-
-When a user signs up for Gnosis Pay, a new **Gnosis Pay Safe** a smart contract wallet is created on-chain.  
-This Safe holds the user’s funds and is controlled only by its **owners**.  
-
-A Gnosis Pay Safe owner can be either:  
-- an **EOA (Externally Owned Account)**, or  
-- another **smart wallet** (e.g. a Safe) whose owners may use passkeys, EOAs, or other signers.  
-
-Funds in a Gnosis Pay Safe are never held by Gnosis Pay or any third party; ownership and control remain entirely with the Safe owners.
-
-<Frame>
-<iframe width="560" height="315" src="https://www.youtube.com/embed/_-FoBiwBJTA?si=-6VlRlqqdYuJhW4j" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
-</Frame>
-
----
-
-## Authenticating sessions with wallets
-
-To access the Gnosis Pay dashboard or APIs, a wallet must authenticate using [Sign-In With Ethereum (SIWE)](https://docs.login.xyz/).  
-After SIWE, a JWT token is issued and used to authorize API calls (e.g. ordering cards, fetching user info, or linking additional authenticated wallets).  
-
-Authenticated wallets are used **only for login and API sessions**. They do not perform on-chain actions and may or may not overlap with the Safe owners.
-
-<Tip>
-The first wallet connected during setup is automatically registered as both an **authenticated wallet** and the **initial Safe owner** (via the Delay Module).
-</Tip>
-
-Follow the guide on [adding an authenticated wallet](account/update-authenticated-account) for step-by-step instructions.
-
----
-
-## Safe Smart Account
-
-Each Gnosis Pay user is assigned a **Safe Smart Account**, a self-custodied smart contract wallet deployed on Gnosis Chain (L1).  
-Currently, a new Safe is deployed for every user. Support for connecting an existing Safe multisig is planned.
-
-### What is a smart contract wallet?
-
-Smart contract wallets are contracts that manage assets on-chain with programmable rules.  
-They enable advanced security and automation beyond EOAs.  
-
-[Safe](https://safe.global/) is the leading smart contract wallet, securing over $70B in assets.
-
-### Exploring the Safe setup
-
-Users can view their Safe configuration in the [Safe web app](https://app.safe.global/) via the Zodiac app:
-
-1. Open the Gnosis Pay Dashboard.  
-2. Click **“View all transactions here”** to open the Safe web app.  
-3. In the sidebar, select **Applications**.  
-4. Search for **Zodiac**.  
-
-The **Roles Module** and **Delay Module** are open-source contracts licensed under LGPL 3.0.
-
----
-
-## Modules
-
-Modules extend Safe functionality with custom logic.  
-In Gnosis Pay, modules enforce spending rules and transaction flows while keeping user funds in self-custody.  
-
-These modules follow the [Zodiac standard](https://gnosisguild.org/zodiac/) developed by Gnosis Guild.
-
----
-
-## Roles Module
-
-The Roles Module enforces which actions Gnosis Pay can perform on behalf of the user. It defines:
-
-1. **Token used** → which token Gnosis Pay can spend.  
-2. **Daily limit** → maximum amount spendable per day.  
-3. **Recipient address** → destination for allowed transfers (e.g. the issuer’s settlement Safe).  
-4. **Role delegation** → assigns these permissions to Gnosis Pay.  
-
-Only Safe owners can update these rules.  
-For example, a user may adjust the daily spending limit at any time.
-
----
-
-## Delay Module
-
-The Delay Module enforces a **3-minute delay** for all non-card transactions (e.g. transfers, deposits).  
-This ensures funds remain available for card payments and prevents race conditions.
-
-<Warning>
-During the 3-minute delay, the card is paused if any non-card transactions are pending.
-</Warning>
-
-The Delay Module also ensures the user’s EOA retains ultimate control.  
-During activation, the EOA becomes an indirect Safe owner via the Delay Module.  
-
-⚠️ Reconfiguring or removing the Delay Module may prevent Gnosis Pay from functioning properly.
-
----
-
-## What happens if I lose access to my EOA Wallet?
-
-If you’ve forgotten the password to your EOA Wallet, you can regain access using its seed phrase.
-
-<Warning>
-However, if you’ve lost access to the seed phrase and cannot regain access to the EOA, you will also lose access to the Safe if it’s the only owner.
-</Warning>
-
-**To mitigate this risk, consider using a [Safe](https://safe.global/) with multiple owners instead of an EOA.**
\ No newline at end of file
diff --git a/account/update-authenticated-account.mdx b/account/update-authenticated-account.mdx
deleted file mode 100644
index 347b59d..0000000
--- a/account/update-authenticated-account.mdx
+++ /dev/null
@@ -1,45 +0,0 @@
----
-title: "Adding a new wallet for authentication"
-description: "Link an additional wallet address to a Gnosis Pay user"
----
-
-A Gnosis Pay user can have multiple authenticated wallets attached to their account.  
-Authenticated wallets are used to sign in via SIWE and to start new API sessions.
-
-<Steps>
-  <Step title="Get a JWT token for the session">
-    Follow the [authentication flow](https://docs.gnosispay.com/auth) to obtain a JWT token for the Gnosis Pay user.
-  </Step>
-
-  <Step title="Add a new wallet address">
-    Make a POST call to [this endpoint](https://docs.gnosispay.com/api-reference/account-management/create-a-new-eoa-account-for-the-current-user) with the address to add.
-
-    ```bash
-    curl --request POST \
-      --url https://api.gnosispay.com/api/v1/eoa-accounts \
-      --header "Authorization: Bearer <token>" \
-      --header "Content-Type: application/json" \
-      --data '{
-        "address": "0x1234567890abcdef1234567890abcdef12345678"
-      }'
-    ```
-  </Step>
-
-  <Step title="Verify that the wallet was added">
-    Call the [list accounts endpoint](https://docs.gnosispay.com/api-reference/account-management/retrieve-the-eoa-accounts-for-the-current-user).  
-    The new address should appear in the response.
-
-    ```bash
-    curl --request GET \
-      --url https://api.gnosispay.com/api/v1/eoa-accounts \
-      --header "Authorization: Bearer <token>"
-    ```
-  </Step>
-</Steps>
-
-<Warning>
-- Adding an **authenticated wallet** only links it to a Gnosis Pay user for login and API sessions.  
-- An authenticated wallet is **not automatically a Safe owner**.  
-- Only Safe owners (EOAs or smart wallets added to the Safe) can interact with the Delay Module or execute on-chain actions.  
-- Authenticated wallets can use the API (e.g. place card orders, fetch user info) but **cannot control funds** unless also added as Safe owners.
-</Warning>
diff --git a/api-reference/auth-app.mdx b/api-reference/auth-app.mdx
deleted file mode 100644
index 8949e78..0000000
--- a/api-reference/auth-app.mdx
+++ /dev/null
@@ -1,26 +0,0 @@
----
-title: Authentication Helper App
-description: Use this app to generate and sign a message using your ethereum wallet.
----
-
-export const AuthApp = () => {
-  return (
-    <div className="flex items-center justify-center" style={{marginTop: '20px'}}>
-      <div className="flex items-center rounded-xl overflow-hidden border border-zinc-950/20 dark:border-white/20" style={{width: '100%', height: '800px'}}>
-        <iframe
-          src="https://gnosispay-api-siwe-demo.vercel.app/"
-          style={{width: '100%', height: '100%'}}
-          title="GnosisPay API SIWE Demo"
-          allow="clipboard-write"
-        />
-      </div>
-    </div>
-  )
-}
-
-
-<a href="https://gnosispay-api-siwe-demo.vercel.app/" target="_blank">
-You can also open this app in a new tab.
-</a>
-
-<AuthApp />
diff --git a/api-reference/intro.mdx b/api-reference/intro.mdx
deleted file mode 100644
index 65e95aa..0000000
--- a/api-reference/intro.mdx
+++ /dev/null
@@ -1,10 +0,0 @@
----
-title: API Reference Introduction
-description: General guidelines on how to integrate with GnosisPay. 
---- 
-
-Gnosis Pay offers an HTTP JSON API, fully documented using [OpenAPI—you can find our specification here](https://api.gnosispay.com/api-docs/spec.json). This API reference is auto-generated from our OpenAPI spec, and you can also use the JSON file to generate client code in various programming languages.
-
-Most API endpoints require authentication with a [JWT obtained via Sign-In with Ethereum (SIWE)](/auth). For your convenience, we provide a [helper app](/api-reference/auth-app) within these docs to help you generate a token and sign Safe transactions.
-
-To make API requests using the API Reference playground, simply paste your token into the Authorization Header field.
diff --git a/auth.mdx b/auth.mdx
deleted file mode 100644
index 789380f..0000000
--- a/auth.mdx
+++ /dev/null
@@ -1,85 +0,0 @@
----
-title: Authentication Flow
-description: Use Sign-In with Ethereum (SIWE) to authenticate API requests.
----
-
-Our authentication system uses Sign-In with Ethereum (SIWE) to generate a `jwt` to interact with our API.
-This means you don't need to handle the storage of a powerful API key or spend hours configuring granular permissions.
-
-<Info>
-**For Partners**: If you're building a partner integration, make sure to register your domains through the [Partners Dashboard](https://partners.gnosispay.com/) during signup. This ensures your domains are whitelisted for SIWE authentication and prevents authentication failures.
-</Info>
-
-
-## Authentication Process
-
-<Steps titleSize="h3">
-<Step title="Generate a Nonce to sign a SIWE Message">
-Before initiating authentication, [the application must request a nonce](/api-reference/authentication/generate-nonce).
-Your application then presents this nonce to the user for signing as part of the SIWE flow.
-
-```bash cURL
-curl -X GET /api/v1/auth/nonce
-```
-</Step>
-<Step title="Sign the SIWE Message with your Wallet or Provider">
-Our API accepts signatures from Externally Owned Accounts (EOAs) and Smart Accounts (EIP-1271).
-
-<Warning>
-The signer must be an owner of a Gnosis Pay account.
-Non-registered users will receive `401 Unauthorized` on most authenticated routes
-</Warning>
-</Step>
-<Step title="Verify the Signature and get an Access Token">
-
-<Note>
-**JWT length validity**
-
-- **Default Validity**: JWT tokens are valid for the duration specified in `ttlInSeconds` during SIWE authentication
-- **Minimum Duration**: 1 hour
-- **Maximum Duration**: 24 hours
-</Note>
-
-After the message is signed, you need to submit both the message and the signature to [retrieve an Access Token](/api-reference/authentication/verify-siwe-signature):
-```bash cURL
-curl -X POST /api/v1/auth/challenge \
-  -H "Content-Type: application/json" \
-  -d '{
-    "message": "string",
-    "signature": "string",
-    "ttlInSeconds": 36000
-  }'
-```
-</Step>
-
-
-</Steps>
-
-<Warning>
-**Domain Whitelisting**: Gnosis Pay validates SIWE domains against a whitelist for security. 
-
-- **localhost**: `localhost` (with or without ports like `localhost:3000`) is automatically allowed for local development
-- **Production domains**: All production and staging domains must be registered through the [Partners Dashboard](https://partners.gnosispay.com/) during signup
-- **127.0.0.1**: Avoid using `127.0.0.1` in SIWE messages as it may cause firewall blocks and "WAFForbidden" errors
-
-Only whitelisted domains (plus localhost) will be accepted for SIWE authentication.
-</Warning>
-
-Upon successful verification, a `jwt` is generated.
-This `jwt` must be included in the Authorization header of all subsequent HTTP requests to authenticate with the Gnosis Pay API:
-
-```bash
-Authorization: Bearer {jwt}
-```
-
-## Details about the Access Token
-
-A `jwt` is generated upon successful Sign-In with Ethereum (SIWE) verification and can remain valid for up to **24 hours**, depending on the **`ttlInSeconds`** parameter passed to SIWE, with a minimum validity period of 1 hour.
-
-To enhance security and prevent replay attacks, each authentication attempt requires a new and unique nonce.
-
-Always ensure that the `jwt` is valid before making API requests.
-If an API request returns a 401 Unauthorized response due to an expired token,
-your application must restart the authentication process, which requires user interaction.
-This means the application must request a new nonce, prompt the user to sign the message,
-and then submit the signature for verification to generate a fresh `jwt`.
diff --git a/cards/assets/PSE-diagram.png b/cards/assets/PSE-diagram.png
deleted file mode 100644
index 85225d0..0000000
Binary files a/cards/assets/PSE-diagram.png and /dev/null differ
diff --git a/cards/assets/card-order-flow.png b/cards/assets/card-order-flow.png
deleted file mode 100644
index fc21d4e..0000000
Binary files a/cards/assets/card-order-flow.png and /dev/null differ
diff --git a/cards/card-order-state-transitions.mdx b/cards/card-order-state-transitions.mdx
deleted file mode 100644
index 688c41d..0000000
--- a/cards/card-order-state-transitions.mdx
+++ /dev/null
@@ -1,183 +0,0 @@
----
-title: Card Order State Transitions
-description: "Understanding the card order state transitions"
----
-Below is the complete state transition diagram and detailed explanations.
-
-### State Transition Diagram
-
-```mermaid
-  stateDiagram-v2
-  [*] --> PENDINGTRANSACTION : Create Order
-
-  PENDINGTRANSACTION --> READY : Pay (free or paid)
-  PENDINGTRANSACTION --> TRANSACTIONCOMPLETE : Payment Complete
-  PENDINGTRANSACTION --> CANCELLED : Cancel
-  PENDINGTRANSACTION --> FAILEDTRANSACTION : Payment Failed
-
-  TRANSACTIONCOMPLETE --> CONFIRMATIONREQUIRED : Request Confirmation
-
-  CONFIRMATIONREQUIRED --> READY : Confirm Ready<br/>(SOF + Phone + Address)
-
-  READY --> CARDCREATED : Create Card<br/>(Physical/Virtual)
-
-  CARDCREATED --> [*] : Order Complete
-  CANCELLED --> [*] : Order Cancelled
-  FAILEDTRANSACTION --> [*] : Order Failed
-
-  note right of PENDINGTRANSACTION
-      Initial state when<br/>order is created
-  end note
-
-  note right of READY
-      Ready for card creation<br/>All requirements met
-  end note
-
-  note right of CARDCREATED
-      Card successfully created<br/>Order fulfilled
-  end note
-```
-
-
-
-### Card Order States
-
-#### Core States
-
-**`PENDINGTRANSACTION`** - *Initial State*
-- **Description**: Order created, awaiting payment or confirmation
-- **Next States**: `READY`, `TRANSACTIONCOMPLETE`, `CANCELLED`, `FAILEDTRANSACTION`
-- **User Actions**: Attach transaction, confirm payment, cancel order
-
-**`TRANSACTIONCOMPLETE`** - *Payment Processed*
-- **Description**: Payment transaction completed but requires additional verification
-- **Next States**: `CONFIRMATIONREQUIRED`
-- **System Actions**: Automatic transition when additional verification needed
-
-**`CONFIRMATIONREQUIRED`** - *Verification Needed*
-- **Description**: Additional user verification required (SOF, phone, address)
-- **Next States**: `READY`
-- **Requirements**: Phone verified, SOF completed, address provided
-
-**`READY`** - *Ready for Card Creation*
-- **Description**: All requirements met, ready to create physical/virtual card
-- **Next States**: `CARDCREATED`
-- **User Actions**: Create card with PIN (physical) or without PIN (virtual)
-
-#### Terminal States
-
-**`CARDCREATED`** - *Success*
-- **Description**: Card successfully created and ready for use
-- **Next States**: None (terminal state)
-- **Note**: Virtual cards are immediately active; physical cards need activation
-
-**`CANCELLED`** - *Cancelled*
-- **Description**: Order cancelled by user or system
-- **Next States**: None (terminal state)
-- **Note**: Only possible from `PENDINGTRANSACTION` state
-
-**`FAILEDTRANSACTION`** - *Payment Failed*
-- **Description**: Payment processing failed
-- **Next States**: None (terminal state)
-- **Note**: User needs to create a new order
-
-### Transition Rules
-
-<Steps titleSize="h3">
-<Step title="Pay Transition">
-`PENDINGTRANSACTION` → `READY`:
-- Free card: `totalAmountEUR === totalDiscountEUR`
-- Paid card: Valid EURe payment to correct address
-- Transaction hash validation (if required)
-</Step>
-
-<Step title="Request Confirmation">
-`TRANSACTIONCOMPLETE` → `CONFIRMATIONREQUIRED`:
-- Triggered when additional user verification is needed
-- System determines extra checks required
-</Step>
-
-<Step title="Confirm Ready">
-`CONFIRMATIONREQUIRED` → `READY`:
-- User phone verified
-- Source of Funds (SOF) completed
-- Valid shipping address (for physical cards)
-</Step>
-
-<Step title="Create Card">
-`READY` → `CARDCREATED`:
-- KYC approved
-- Risk score: Green or Orange
-- For physical cards: Encrypted PIN required
-- For virtual cards: No PIN needed
-</Step>
-
-<Step title="Cancel">
-`PENDINGTRANSACTION` → `CANCELLED`:
-- Only from `PENDINGTRANSACTION` state
-- User-initiated or admin-initiated
-</Step>
-</Steps>
-
-### Error Handling
-
-When implementing card order, consider these scenarios:
-
-**Invalid Transitions**
-Will throw TransitionError
-- Trying to cancel from READY state
-- Attempting to create card from `PENDINGTRANSACTION`
-- Any transition not defined in the state machine
-
-
-**Common Error Scenarios**
-- **Payment Issues**: Transaction hash already used, insufficient payment
-- **User Requirements**: Missing KYC, unverified phone, missing address
-- **System Issues**: Payment processor errors, card creation failures
-
-### Implementation Example
-
-```javascript
-// Check current order state before taking action
-const handleOrderAction = async (order, action) => {
-  switch (order.status) {
-    case 'PENDINGTRANSACTION':
-      if (action === 'pay') {
-        await confirmPayment(order.id);
-      } else if (action === 'cancel') {
-        await cancelOrder(order.id);
-      }
-      break;
-
-    case 'READY':
-      if (action === 'createCard') {
-        await createCard(order.id, { setPin: !order.virtual });
-      }
-      break;
-
-    case 'CARDCREATED':
-      // Order complete - handle card activation if needed
-      break;
-
-    default:
-      throw new Error(`Cannot perform ${action} on order with status ${order.status}`);
-  }
-};
-```
-
-### Cancellable States
-
-Orders can only be cancelled from specific states. Use the `CANCELLABLE_ORDER_STATUSES` constant:
-
-```javascript
-const CANCELLABLE_ORDER_STATUSES = [
-  'PENDINGTRANSACTION',
-  'TRANSACTIONCOMPLETE',
-  'CONFIRMATIONREQUIRED',
-  'FAILEDTRANSACTION'
-];
-```
-
-<Warning>
-**State Validation**: Always validate the current order state before attempting transitions. Invalid transitions will throw a `TransitionError` and return HTTP 422 status code.
-</Warning>
diff --git a/cards/concepts.mdx b/cards/concepts.mdx
deleted file mode 100644
index b8ab122..0000000
--- a/cards/concepts.mdx
+++ /dev/null
@@ -1,70 +0,0 @@
----
-title: Cards Concepts
-description: "Core concepts for card management, PINs, and merchant categories"
----
-
-Cards are their own domain, with lots of edge cases all around and a unique set of terms.
-On this document, we aim to present the most common concepts related to operating cards
-and what to expect of them.
-
-This is not an extensive guide and we encourage you to use this document as a way to start
-your journey. Both VISA and Mastercard have great resources and guides that you can also use.
-
-<Note>
-  For transaction-related concepts like payments, refunds, and reversals, see our dedicated
-  [Card Transactions](/transactions) guide.
-</Note>
-
-## Card Lifecycle
-
-Cards go through several states during their lifetime:
-
-### Card States
-- **Inactive**: Card created but not yet activated
-- **Active**: Card activated and ready for use
-- **Frozen**: Temporarily disabled (can be unfrozen)
-- **Lost**: Reported as lost (requires replacement)
-- **Stolen**: Reported as stolen (requires replacement)
-- **Expired**: Past expiration date (requires replacement)
-
-### Card Activation
-New cards must be activated before first use. Activation typically involves:
-- Verifying cardholder identity
-- Setting initial PIN (if required)
-- Confirming card receipt
-- Enabling spending limits
-
-### Card Management Operations
-- **Freeze/Unfreeze**: Temporarily disable card usage
-- **Report Lost/Stolen**: Permanently disable and request replacement
-- **Update Limits**: Modify spending or withdrawal limits
-- **PIN Management**: Change or reset PIN
-
-## Disputes
-
-Disputes are used to recover funds for captured transactions. Their main use-case is to revert fraudulent transactions
-or problems with the product or service paid for. Fraud and non-fraud disputes have different requirements and rules,
-and undergo through different analysis to reach a conclusion.
-
-### Dispute Types
-- **Fraud disputes**: Unauthorized transactions
-- **Non-fraud disputes**: Issues with goods/services received
-- **Processing errors**: Technical or merchant errors
-
-### Dispute Process
-1. **Initiation**: Cardholder reports disputed transaction
-2. **Investigation**: Review transaction details and evidence
-3. **Provisional Credit**: Temporary refund while investigating
-4. **Resolution**: Final decision and permanent credit/debit
-
-## Card PINs
-
-Visa cards have 2 places to store the PIN - the first place is on the physical card chip, called the **offline PIN**, and the second is the **online PIN** that is stored in the bank's system. While these PINs usually have the same value, there can be cases where they differ, for instance when you change the card PIN.
-
-When paying at a point of sale (in a restaurant or in a shop), only the offline PIN may be verified, while ATMs usually connect to the bank network and check the online PIN. When using the PSE to change the PIN, only the online PIN is changed. At this point, the offline PIN is **not updated** since physical access to the card is needed to change the PIN on the chip. To update the offline PIN, you need to go to an ATM and perform any operation. ATM transactions always go online to the card issuer. This allows the issuer to send an "issuer script" to your card, which updates the offline PIN stored on the chip, synchronizing it with any recent PIN changes made online (with PSE). Without this synchronization, your offline PIN might be outdated and cause issues for transactions that rely on offline verification.
-
-## MCC: Merchant Category Code
-
-Merchant Category Codes (MCCs) are used to classify businesses based on the types of goods or services they provide.
-These codes are important as they are often used for calculating interchange fees, authorizing payments, and preventing fraud.
-Additionally, specific MCCs are required for particular functionalities.
diff --git a/cards/create-physical-cards.mdx b/cards/create-physical-cards.mdx
deleted file mode 100644
index 6ae1be3..0000000
--- a/cards/create-physical-cards.mdx
+++ /dev/null
@@ -1,110 +0,0 @@
----
-title: "Create Physical Cards"
-description: "Order physical cards for your Users."
----
-
-
-## Create Physical Card Process
-
-<Steps titleSize="h3">
-<Step title="Create a Card Order">
-
-
-[This endpoint creates a new `CardOrder` with the status of `PENDINGTRANSACTION`](/api-reference/physical-card-order/create-physical-card-order):
-
-```bash cURL
-curl -X POST /api/v1/order/create
-```
-
-The Card Order is created with the following data:
-
-- A shipping address can be specified by filling the `shippingAddress` field, see [endpoint specifications](/api-reference/physical-card-order/create-physical-card-order). If not set, the KYC address will be used for shipping.
-- The total amount to be paid is set in EURe. The amount is 30.23.
-- A coupon code can be applied to reduce the amount to be paid, either at signup or in the next step
-
-</Step>
-<Step title="(Optional) Attach a Coupon">
-
-[This endpoint attaches a coupon to the `CardOrder` with `orderId`](/api-reference/physical-card-order/attach-a-coupon-to-a-physical-card-order):
-
-```bash cURL
-curl -X POST /api/v1/order/{orderId}/attach-coupon
-```
-
-The coupon needs to be valid, otherwise an error is thrown.
-If the user has a coupon code both from the signup, and from this step, the one from the signup takes precedence.
-
-</Step>
-<Step title="(Optional) Attach an on-chain transaction">
-
-<Note>
-This is only needed if the card is not free. If `CardOrder.totalAmountEUR` is the same as the `CardOrder.totalDiscountEUR` then the card is considered free.
-</Note>
-
-[This endpoint allows setting a transaction hash to the specified `orderId`](/api-reference/physical-card-order/register-payment-for-a-physical-card-order).
-
-```bash cURL
-curl -X PUT /api/v1/order/{orderId}/attach-transaction \
--d '{
-  "transactionHash": "0x..."
-}'
-```
-
-The transaction can only be used once across all card orders.
-
-</Step>
-<Step title="Confirm the payment was performed">
-
-<Warning>
-This endpoint must be called even if the card is free. It moves the card order to the `READY` status.
-</Warning>
-
-[To confirm the payment call this endpoint](/api-reference/physical-card-order/confirm-the-payment-for-a-physical-card-order):
-
-```bash cURL
-curl -X PUT /api/v1/order/{orderId}/confirm-payment
-```
-
-The conditions for the payment are:
-
-- In order to call this endpoint, the `CardOrder.status` needs to be `PENDINGTRANSACTION`.
-- If the card is not free, we check if a payment was done.
-  - Token used for payment needs to be EURe `0xcB444e90D8198415266c6a2724b7900fb12FC56E`.
-  - Payment was done to `0x3D4FD6a1A7a1382ae1d62C3DD7247254a0236847`.
-  - The respective EURe amount was paid in that transaction hash (partial transfers are not supported).
-
-If all the conditions above are met, the `CardOrder.status` is set to `READY`.
-</Step>
-<Step title="Create the Physical Card">
-[Finally, you can create the Physical Card](/api-reference/physical-card-order/create-a-physical-card):
-
-```bash cURL
-curl -X POST /api/v1/order/:orderId/create-card
-```
-
-When successful, this endpoint returns the `cardToken` from the newly created card.
-
-In order to create a `Card` out of a `CardOrder` the following conditions need to be met:
-
-- No cards were created out of this `orderId`.
-- User needs to have a verified phone number.
-- User needs to have a name set.
-- User needs to be from a supported country.
-- User address needs to be set.
-- User needs to have an approved KYC.
-- The risk score needs to be Green or Orange based on the user's answers to the Source of funds questionnaire.
-- User needs to have the shipping details for the physical card order set.
-  - The shipping details can be different from the KYC address, as long as it is in the same country.
-  - Virtual cards do not require a shipping address.
-- The embossed name for the card needs to be set.
-</Step>
-<Step title="Set the Card PIN using the Partner Secure Elements (PSE)">
-
-The card PIN should be set immediately after the card is created via the Partner Secure Elements (PSE).
-Use the `cardToken` returned from the previous endpoint to set the PIN.
-If a PIN is not provided upon creation, a random one will be assigned.
-Changing this randomly assigned PIN requires the user to visit an ATM. Refer to the **[card PINs section](/cards#card-pins)** to learn more about the online and offline PINs.
-
-For detailed instructions about how to change the PIN, please refer to the [PSE SDK documentation](/cards/pse-integration).
-</Step>
-</Steps>
diff --git a/cards/create-virtual-cards.mdx b/cards/create-virtual-cards.mdx
deleted file mode 100644
index a623642..0000000
--- a/cards/create-virtual-cards.mdx
+++ /dev/null
@@ -1,41 +0,0 @@
----
-title: Create Virtual Cards
-description: Virtual cards work either online or tap in presence (with Apple Pay and Google Pay).
----
-
-Virtual card orders have a **simplified flow** compared to physical cards, with these key differences:
-
-- No shipping address is required
-- The card is available immediately after order creation (no shipping delay)
-- Virtual cards can be used for online transactions immediately
-- Thanks to Google and Apple Pay (some regions are not yet available), the card can be used for in-person transactions immediately.
-- No PIN is required; the user's phone number is used as second factor authentication for some online payments
-- **Cards are automatically created and activated when the order is placed**
-
-## How to create a Virtual Card
-
-[This endpoint allows you to issue a virtual card directly](/api-reference/card-management/create-a-virtual-card):
-
-```bash cURL
-curl -X POST /api/v1/cards/virtual
-```
-
-Virtual cards are free and activated immediately. No shipping address or payment validation required.
-
-
-<Warning>
-**Automatic Card Creation**: By calling this endpoint, the virtual card is automatically created if the user's Safe account is properly configured. You do not need to call any other endpoint.
-</Warning>
-
-
-[The virtual card should appear immediately in the card list available with the endpoint](/api-reference/card-management/list-all-cards):
-
-```bash cURL
-curl /api/v1/cards?status_code=1000
-```
-
-The `status_code=1000` query parameter returns only active cards.
-
-<Note>
-Card Limits: Users can have a **maximum of 5 active cards including physical and virtual cards combined**. Active cards exclude voided, lost, and stolen cards.
-</Note>
diff --git a/cards/pse-integration.mdx b/cards/pse-integration.mdx
deleted file mode 100644
index 5e703f8..0000000
--- a/cards/pse-integration.mdx
+++ /dev/null
@@ -1,220 +0,0 @@
----
-title: Partner Secure Elements (PSE) Integration
-description: Access sensitive Card information from your client application.
----
-
-## Overview
-
-If you want to display sensitive information, such as card numbers, in your front-end, you'll need to interact with our **Partner Secure Elements (PSE)** service. The easiest way to do this is by using the [PSE SDK](https://www.npmjs.com/package/@gnosispay/pse-sdk) from Gnosis Pay.
-
-To initialize the SDK, you'll need an `App ID` provided to you upon registration with Gnosis Pay. You'll also need an **ephemeral-token**. This ephemeral-token can be retrieved with a call to our private PSE API using mTLS authentication.
-
-<Warning>
-  **Backend Only**: An mTLS authentication can only be performed from a
-  back-end. For this reason, you need a back-end responsible for retrieving the
-  ephemeral-token and sending it to your front-end upon request. We'll go
-  through each step in this guide.
-</Warning>{" "}
-
-Once your front-end has the ephemeral-token, it can initialize the PSE SDK and use it to display secure elements.
-
-Here's a diagram showing each step:
-
-```mermaid
-    sequenceDiagram
-        participant FE as Your Frontend
-        participant BE as Your Backend
-        participant API as PSE API
-
-        FE->>BE: Get ephemeral-token
-        BE->>API: Get ephemeral-token (mTLS Certificates)
-        API-->>BE: Receive ephemeral-token
-        BE-->>FE: Receive ephemeral-token
-
-        Note over FE: Initialize PSE SDK with ephemeral-token and App ID
-
-        FE->>API: PSE SDK Requests Card Information
-        API-->>FE: Display Card Information Inside an Iframe
-```
-
-Reference implementations are available for a [front-end](https://github.com/gnosispay/ui) and a [back-end](https://github.com/gnosispay/ui/tree/main/pse-backend-demo).
-
----
-
-## Secure Connection Using mTLS Authentication
-
-**Mutual TLS (mTLS)** is a type of authentication in which two parties in a connection authenticate each other using the TLS protocol. Your back-end will establish an mTLS authentication with the Gnosis Pay private PSE API to receive an ephemeral-token.
-
-### How to Generate mTLS Certificates
-
-After signing up through the [Partners Dashboard](https://partners.gnosispay.com/), you will receive an `App ID` instantly, which will be used in the certificate generation below. You must first create a private key and then generate a Certificate Signing Request (CSR) using the `App ID` as follows:
-
-```graphql
-# APP_ID is a string starting with `gp_` that you have received from Gnosis Pay
-export APP_ID="gp_woop_123"
-
-# Create a private key (NEVER share with anyone)
-openssl ecparam -name prime256v1 -genkey -noout -out "${APP_ID}.key.pem"
-
-# Create the CSR (OK to share)
-openssl req -new -sha256 -key "${APP_ID}.key.pem" -out "${APP_ID}.csr.pem" -subj "/CN=${APP_ID}"
-```
-
-You can now share the `${APP_ID}.csr.pem` file with the Gnosis Pay team. **DO NOT EVER** share the `.key.pem` file with **ANYONE**.
-
-Once we receive your Certificate Signing Request, we will sign it and send you back the signed certificates. These signed certificates, along with your private key, are used to establish the connection with the PSE API.
-
-### How to Establish an mTLS Authentication (in Node.js)
-
-You should securely store the certificates in your environment along with your private key.
-
-Your environment should expose the certificates and private key, for example:
-
-```rust
-SIGNED_CERTIFICATES="-----BEGIN CERTIFICATE-----
-ABCQz ....
------END CERTIFICATE-----
------BEGIN CERTIFICATE-----
-DEFC7 ....
------END CERTIFICATE-----
------BEGIN CERTIFICATE-----
-GHICc ....
------END CERTIFICATE-----"
-
-PRIVATE_KEY="-----BEGIN EC PRIVATE KEY-----
-ABCD....
------END EC PRIVATE KEY-----"
-```
-
-Here's a Node.js implementation to request the ephemeral-token in two different ways:
-
-<CodeGroup>
-
-```js Using Axios
-const httpsAgent = new https.Agent({
-  cert: process.env.SIGNED_CERTIFICATES,
-  key: process.env.PRIVATE_KEY,
-  rejectUnauthorized: true, // Ensure SSL verification
-});
-
-const ephemeralTokenRequest = await axios({
-  httpsAgent: httpsAgent,
-  method: "POST",
-  url: `https://api-pse.gnosispay.com/api/v1/ephemeral-token`,
-  headers: { "Content-Type": "application/json" },
-  // Axios adds the user-agent automatically
-});
-```
-
-```js Using https.request
-import https from "https";
-
-const httpsAgent = new https.Agent({
-  cert: CERT,
-  key: KEY,
-  rejectUnauthorized: true,
-});
-
-const req = https.request(
-  {
-    hostname: "api-pse.gnosispay.com",
-    path: "/api/v1/ephemeral-token",
-    method: "POST",
-    headers: {
-      "Content-Type": "application/json",
-      "User-Agent": "User-Client/1.0.0",
-    },
-    agent: httpsAgent,
-  },
-  (res) => {
-    let data = "";
-    res.on("data", (chunk) => {
-      data += chunk;
-    });
-
-    res.on("end", () => {
-      console.log("Status:", res.statusCode);
-
-      try {
-        const parsedData = JSON.parse(data);
-        console.log("Response:", parsedData);
-      } catch {
-        console.log("Raw response:", data);
-      }
-    });
-  }
-);
-
-req.on("error", (error) => {
-  console.error("Request error:", error);
-});
-req.end();
-```
-
-</CodeGroup>
-
-Please refer to our [API documentation](/api-reference/endpoints/generate-a-new-ephemeral-token) on the PSE service for more information about the specific endpoint.
-
-<Note>
-  The ephemeral-token, as its name suggests, is valid for a very short time
-  frame. It is advised to generate a new one for every usage of the SDK.
-</Note>
-
----
-
-## How to Use the PSE SDK
-
-The PSE SDK will help you display sensitive information. It injects secure iframes into your front-end and exposes callbacks to interact with it. Refer to the [PSE SDK documentation](https://www.npmjs.com/package/@gnosispay/pse-sdk) for instructions and examples.
-
-## How to Customize the Style of Secure Elements in the iframe
-
-For security reasons, the only way to apply custom styling to iframe elements is to prepare and share a **CSS file** with the Gnosis Pay team. This file, named `<partner_name>.css`, will be incorporated into the iframe.
-
-Standard styling is applied to the iframe elements by default. You can override the style of these classes and IDs as needed. Here are some of them:
-
-#### Card Data
-
-- `.pse-container` - A shared class for all iframe containers.
-- `#pse-card-data-container` - The main container for displaying card data.
-- `.pse-card-field` - The container for each card data field (card number, expiry date, security code).
-- `.pse-card-label` - Labels for each field.
-- `.pse-card-value` - The container for the actual card data values.
-
-#### Set PIN Form
-
-- `.pse-container` - A shared class for all iframe containers.
-- `#pse-set-pin-form` - The main form container.
-- `#pse-set-pin-success-container` - The success state container.
-- `.pse-set-pin-container` - The base container class.
-- `.pse-set-pin-button` - The base class for all buttons.
-- `#pse-continue-pin-button` - The continue button.
-- `#pse-done-button` - The done button.
-
----
-
-### Styling Guide
-
-Here is a suggested workflow to customize the styling:
-
-1.  In your front-end, load the element you wish to customize (e.g., the card data).
-1.  Locate the custom CSS file with your name in either the "**Style Editor**" in Firefox or the "**Sources**" panel on Chrome/Brave. In the example below, the file is `gnosis_pay_ui.css`.
-1.  Apply your desired styling. The changes will be reflected in your interface immediately.
-1.  Save the file and send it to Gnosis Pay for application in production.
-
-Here is an example of overriding the `.pse-card-field` class in Firefox:
-![custom css](./assets/css-styling.png)
-
-## React Native Integration
-
-If you'd like to integrate the PSE SDK into a React Native application, you can use the [React Native PSE SDK](https://www.npmjs.com/package/@gnosispay/pse-react-native) package to help integrating the WebView piece.
-
-However, as the PSE requires hosting on your domain, you will still need to host the PSE Frame on your backend, on your domain.
-
-This frame can be as simple as an HTML page that invokes the PSE JS SDK.
-
-In our reference implementation repository, next to the examples of implementing backend endpoint for ephemeral token generation, you can
-find [an example of such page](https://github.com/gnosispay/ui/blob/main/pse-backend-demo/src/static/native-webview.html) returned by the same backend that generates the ephemeral token.
-
-Note that this page should be responsible for fetching the ephemeral token from your backend, and passing it to the PSE JS SDK.
-
-You will then pass this URL to the React Native WebView component, through the `webViewUrl` prop, together with other parameters that you can find in the [React Native PSE SDK documentation](https://www.npmjs.com/package/@gnosispay/pse-react-native).
diff --git a/changelog/index.mdx b/changelog/index.mdx
new file mode 100644
index 0000000..8310fa6
--- /dev/null
+++ b/changelog/index.mdx
@@ -0,0 +1,9 @@
+---
+title: "Changelog"
+description: "New features, improvements, and fixes for Gnosis Pay"
+---
+
+<Update label="Coming soon">
+  We're putting the finishing touches on our public API and docs. Changelog
+  entries will start appearing here shortly.
+</Update>
diff --git a/concepts/accounts/account-status.mdx b/concepts/accounts/account-status.mdx
new file mode 100644
index 0000000..0691e9b
--- /dev/null
+++ b/concepts/accounts/account-status.mdx
@@ -0,0 +1,17 @@
+---
+title: "Account Status"
+---
+
+An account moves through a small set of statuses over its lifecycle. The table below describes what each status means and what, if anything, is expected from the user or partner while an account is in it.
+
+| Status | What it means
+|---|---|
+| **Provisioning** | The account is being created and its card Safe is being configured. This is a transitional status that should resolve automatically as part of account setup. |
+| **Active** | The account is active and fully operational. The user can fund their account, use their card, and access all account features. |
+| **Blocked** | The account has been blocked and cannot be used. All active cards are restricted and no new cards can be created. Can be blocked by the partner (via Dashboard) or by Gnosis Pay directly. |
+| **Closed** | The account has been permanently closed. |
+
+
+<Warning>
+  **Closed account** cannot be reopened or reactivated under any circumstances.
+</Warning>
diff --git a/concepts/accounts/account.mdx b/concepts/accounts/account.mdx
new file mode 100644
index 0000000..e925759
--- /dev/null
+++ b/concepts/accounts/account.mdx
@@ -0,0 +1,41 @@
+---
+title: "Account Overview"
+description: "Understanding what a Gnosis Pay account is and how spending limits work"
+---
+
+A Gnosis Pay account is created once a user has been fully onboarded and has completed KYC.
+
+## Token and Safe configuration
+
+When an account is provisioned, it's configured with the **token** that the account will spend from. This token, along with a linked **Safe**, defines the account's spending source: the Safe is authorized to spend the configured token on behalf of the account.
+
+## Account spending limits
+
+Gnosis Pay accounts support configurable spending limits at two levels:
+
+- **User-configured limits** : users can set their own account limit, giving them direct control over how much they spend, independent of any partner-level configuration.
+- **Partner-configured limits** : as a partner, you can apply a custom limit on an account, up to a maximum limit set for that account type.
+
+<Info>
+  These two levels work together: a partner can define the limit for an account based on their program setup with Gnosis Pay, while the user retains control to set a stricter limit within it for their own spending discipline.
+</Info>
+
+<Note>
+  To apply for a custom limit for your users, [contact sales].
+</Note>
+
+## Multi-currency support
+
+A single account can hold and transact in multiple currencies, so users aren't restricted to a single-currency balance.
+
+<Note>
+  Multi-currency setup is not enabled by default. To request it for your program with Gnosis Pay, [contact sales].
+</Note>
+
+Because Gnosis Pay cards run on the **Visa network**, which accepts merchants worldwide, a purchase can be either a **domestic transaction** (merchant currency matches the account's currency) or an **international transaction** — in which case it becomes an **FX transaction**, converting between the account's currency and the currency the merchant is charging in.
+
+<Info>
+  As a partner, you can also customize the **FX fees** applied to these conversions, giving you control over how international spend is priced for your users.
+</Info>
+
+To find out which tokens are supported, visit the [Tokens and Chains Supported](/concepts/safe/tokens-and-chains-supported) page.
diff --git a/concepts/architecture.mdx b/concepts/architecture.mdx
new file mode 100644
index 0000000..117879e
--- /dev/null
+++ b/concepts/architecture.mdx
@@ -0,0 +1,65 @@
+---
+title: "Gnosis Pay Architecture"
+description: "How onboarding, spending, and settlement flow through Gnosis Pay"
+---
+
+Gnosis Pay is the orchestration layer that connects KYC flows, self custody of funds through safe account, KYT/AML checks on funds transfer, payment processing, and settlement. The diagram below shows how each system plugs in.
+
+<img src="/static/img/gnosis-pay-architecture.svg" alt="Gnosis Pay architecture" />
+
+
+The diagram reads in two directions. From the top down, it shows how a **partner** integrates. From the user's journey through the middle and bottom, it shows what an **end user** experiences.
+
+## For partners
+
+You integrate with Gnosis Pay infrastructure and get assigned a TenantID (also referred as PartnerID, which is an idenitifier for you as a partner) and allows us to spin up dedicated credentials to access userbase.
+
+Partner infrastructure has three components:
+
+<CardGroup cols={2}>
+  <Card title="User Onboarding API" icon="user-plus">
+    Onboard your users end-to-end wallet sign-in with SIWE, email and TOS, and KYC. You can drive the full flow through the API or bring your own onboarding. If you have Sumsub instance, you can also perform KYC sharing
+  </Card>
+  <Card title="Webhooks" icon="bell">
+    Subscribe to real-time events to keep your systems in sync and power notifications to your users.
+  </Card>
+  <Card title="Partner Dashboard" icon="gauge">
+    Manage your program, support your users (B2C), and access analytics and user data — so you own the relationship directly.
+  </Card>
+  <Card title="PSE" icon="lock">
+      A partner-hosted secure element for displaying sensitive card details (PAN, CVV, expiry) on your own domain. Authenticated with mTLS.
+    </Card>
+</CardGroup>
+
+
+Gnosis Pay as the orchestration layer exposes three domains:
+
+- **Account** : create and manage user accounts, balances, and limits.
+- **Card**: issue and control virtual cards, card limits and control.
+- **Processing + Settlement**: authorization, transaction processing, and settlement across the payment rails. We also handle chargebacks and disputes.
+
+
+## For users
+
+From the end user's point of view, the platform moves them from sign-in to spending in a single continuous flow.
+
+<Steps>
+  <Step title="Sign in">
+    The user connects their wallet with SIWE (Sign-In with Ethereum), verifies their email, and accepts the terms of service.
+  </Step>
+  <Step title="Verify identity">
+    The user completes KYC through Sumsub. Once verified and approved, their KYC is to be linked with user account.
+  </Step>
+  <Step title="Get an account and card">
+    Gnosis Pay provisions the user's account with Pismo and deploys their **Spending Safe** — a self-custodial Safe where the user's funds are held. A card is issued against the account. During this deployment, we also set the user's spendable currency and primary token that is allowed to be spent from user's safe.
+  </Step>
+  <Step title="Fund the Safe">
+    The user deposits funds into their Spending Safe. Every deposit is screened by **KYT** (AML) before the funds become spendable.Because the Spending Safe is self-custodial, the user keeps control of their funds throughout deposits, balances, and withdrawals.
+  </Step>
+  <Step title="Spend">
+    When the user pays with their card, the transaction is authorized in real time against the account balance and balance is moved accordingly on ledger.
+  </Step>
+  <Step title="Settlement">
+    Spending is settled through Monavate on a 12-hour batch.
+  </Step>
+</Steps>
diff --git a/concepts/auth/token.mdx b/concepts/auth/token.mdx
new file mode 100644
index 0000000..42cb764
--- /dev/null
+++ b/concepts/auth/token.mdx
@@ -0,0 +1,54 @@
+---
+title: "Authentication & Token Management"
+description: "Understanding SIWE auth, and how access/refresh tokens work"
+---
+
+Gnosis Pay authenticates users through **Sign-In with Ethereum (SIWE)** following EIP 4361 in which it verifies a **cryptographic signature** produced by the user's wallet proving control of the address.
+
+Once that signature is verified, the API issues a pair of tokens (**access** and **refresh**) that represent the authenticated session going forward. This page explains the reasoning behind both pieces: why SIWE, and how the token system keeps a session secure without asking the user to sign a message on every request.
+
+## Sign in with Ethereum
+
+SIWE (formalized as **EIP-4361**) defines a standard, human-readable message format that a wallet signs to prove address ownership.
+
+- **Signed message:** The signed message itself states *who* is authenticating, *for which domain*, at *what time*, and often includes a random nonce. The user can visually inspect what they're agreeing to before signing, rather than blindly approving an opaque hash.
+- **Domain-bound:** Because the message includes the requesting domain, a signature obtained on `app.example.com` can't be silently replayed against Gnosis Pay's own domain by a malicious site — this is what domain whitelisting on our side enforces.
+- **Replay resistance:** The nonce and timestamp in the message mean a captured signature can't be reused indefinitely to mint new sessions.
+
+
+## Session Management against Auth token
+
+A signature proves identity for a single moment — it doesn't create an ongoing session by itself. So once SIWE verification succeeds, Gnosis Pay issues two tokens that stand in for "this address is authenticated" over time:
+
+| | Access Token | Refresh Token |
+|---|---|---|
+| **Lifespan** | 15 minutes | 7 days |
+| **Format** | Stateless JWT | Opaque random string |
+| **Role** | Proves the session on each request | Used only to mint a new access token |
+| **Where it should live** | Memory / short-lived storage | Secure, encrypted storage |
+
+## Why tokens rotate
+
+Every time a refresh token is used, it's invalidated and replaced with a new one this is **token rotation**. The old refresh token becomes permanently unusable the moment a new one is issued, even if it hasn't expired yet.
+
+This turns refresh tokens into a kind of tripwire: in normal operation, only one "version" of a session's refresh token is ever valid at a time. If a refresh token is ever used *twice*, once by the legitimate client, once by an attacker who copied it the system can detect that the token has already been consumed and end the session for everyone holding a copy.
+
+```mermaid
+sequenceDiagram
+    participant Wallet
+    participant Gnosis Pay
+
+    Wallet->>Gnosis Pay: Sign SIWE message (EIP-4361)
+    Gnosis Pay->>Wallet: Verify signature → issue Access + Refresh Token
+
+    Note over Wallet,Gnosis Pay: Access Token proves the session (15 min)
+
+    Note over Wallet,Gnosis Pay: Access Token expires
+
+    Wallet->>Gnosis Pay: Present Refresh Token
+    Gnosis Pay->>Wallet: Invalidate old Refresh Token → issue new Access + Refresh Token
+```
+
+<Info>
+  For the actual request/response and endpoints to implement this flow, see the [Authentication Guide](/guides/auth-with-siwe).
+</Info>
diff --git a/concepts/card/decline-codes.mdx b/concepts/card/decline-codes.mdx
new file mode 100644
index 0000000..1206a72
--- /dev/null
+++ b/concepts/card/decline-codes.mdx
@@ -0,0 +1,283 @@
+---
+title: "Card Decline Reasons"
+description: "Every card decline code, the customer-facing message shown, and its technical cause"
+---
+
+When a card transaction is declined, Gnosis Pay returns a decline code and a customer-facing message via the Partner API, webhooks, and on the Partner Dashboard. The 90+ underlying technical codes from Pismo are grouped into customer-facing categories, so cardholders see clear, actionable language rather than a raw processor code.
+
+This page lists every code by category, the message shown to the user, and the technical reason behind it — useful when investigating a specific decline with your support team.
+
+<Note>
+  A code not listed here falls back to a generic message: *"Transaction denied (code: `{code}`)"*.
+</Note>
+
+## 1. Temporary issue
+
+**Message shown to user:** *"Temporary issue. Please try again."*
+
+Transient, infrastructure-level failures. Retrying the transaction typically resolves them.
+
+| Code | Technical Reason |
+|---|---|
+| `91` | Authorization system or issuer system inoperative |
+| `998` | Card hash not present in database |
+| `ACE` | Network transactions API communication error |
+| `ACT` | Account timeout |
+| `AEE` | Anti-fraud external generic error |
+| `AET` | Anti-fraud external API timeout |
+| `AFE` | Anti-fraud internal API generic error |
+| `AGE` | Account generic error |
+| `AIT` | Anti-fraud internal API timeout |
+| `ANF` | Acceptance not found |
+| `AUD` | Authorization disabled |
+| `BCE` | Balance config generic error |
+| `BCT` | Balance config timeout |
+| `BII` | Balance inquiry internal error |
+| `CET` | Card timeout |
+| `CGE` | Card generic error |
+| `CLF` | Credit limit impact not found |
+| `CMD` | Card mode disabled |
+| `CNU` | Account status unknown |
+| `CTT` | Card token timeout |
+| `CV3` | CVC3 not configured |
+| `DCE` | Distributor API communication error |
+| `ETR` | Exceed time to reversal |
+| `FR3` | IAV validation failed |
+| `FR7` | Card not present in database |
+| `HCE` | HSM communication error |
+| `IMA` | Invalid message authentication code |
+| `IMF` | Invalid message format |
+| `IZA` | Zero amount not allowed |
+| `LAE` | Unexpected error fetching account information |
+| `LCT` | Ledger account timeout |
+| `LNF` | Account not found |
+| `LUD` | Limit update duplicated ID error |
+| `LUE` | Error updating ledger |
+| `LUT` | Ledger timeout |
+| `OOT` | Orgs operation timeout |
+| `OP1` | Generic error or system failure |
+| `PAE` | Unexpected error fetching parameters |
+| `PAT` | Timeout fetching parameters |
+| `PCT` | Timeout in processing code definition |
+| `PGE` | Program config generic error |
+| `PRE` | Unexpected error fetching program |
+| `PRT` | Timeout fetching program |
+| `RAD` | Rates API denial |
+| `RAE` | Error on authorization amount calculation |
+| `STD` | Denied by second authorizer |
+| `TGE` | Card token generic error |
+| `ZBA` | Zero balance API unauthorized |
+| `ZBE` | Zero balance API general error |
+| `ZBF` | Zero balance client webhook forbidden |
+| `ZBP` | Partial authorization response invalid in zero balance purchases |
+| `ZBT` | Zero balance API timeout |
+| `ZBU` | Zero balance client webhook unavailable |
+
+## 2. Card could not be read
+
+**Message shown to user:** *"Card could not be read. Please try again."*
+
+| Code | Technical Reason |
+|---|---|
+| `FAT` | ATC validation failed |
+| `FRE` | Cryptogram data validation failed |
+| `FRH` | POS entry mode validation failed |
+| `FRN` | Chip field validation failed |
+| `FRO` | Chip signature validation failed |
+
+## 3. Card status invalid
+
+**Message shown to user:** *"Card status invalid. Contact support."*
+
+| Code | Technical Reason |
+|---|---|
+| `BNI` | Card is inoperative |
+| `BNW` | Card has warning status |
+| `CSU` | Card status unknown |
+
+## 4. Card transaction limit reached
+
+**Message shown to user:** *"Card transaction limit reached."*
+
+| Code | Technical Reason |
+|---|---|
+| `CTE` | Transaction counter exceeded |
+
+## 5. Mismatched key value for DCC
+
+**Message shown to user:** *"Mismatched key value for DCC"*
+
+| Code | Technical Reason |
+|---|---|
+| `DIC` | Invalid country for DCC definition |
+| `DIY` | Invalid currency for DCC definition |
+
+## 6. Card not activated
+
+**Message shown to user:** *"Card not activated. Please activate."*
+
+| Code | Technical Reason |
+|---|---|
+| `FRB` | Card is in created status (not activated) |
+
+## 7. Card no longer valid
+
+**Message shown to user:** *"Card no longer valid."*
+
+| Code | Technical Reason |
+|---|---|
+| `VED` | Card is deleted |
+
+##8. Mismatched key value for refund
+
+**Message shown to user:** *"Mismatched key value for Refund."*
+
+| Code | Technical Reason |
+|---|---|
+| `DCM` | Original authorization not found at refund |
+
+## 9. Currency conversion not permitted
+
+**Message shown to user:** *"Currency conversion not permitted. Select local currency."*
+
+| Code | Technical Reason |
+|---|---|
+| `DCC` | DCC transaction not allowed for program |
+
+## 10. Security check failed
+
+**Message shown to user:** *"Security check failed. Please try again."*
+
+| Code | Technical Reason |
+|---|---|
+| `CAV` | CAVV 3DS validation failed |
+
+## 11. Payment declined, contact support
+
+**Message shown to user:** *"Payment declined. Contact support."*
+
+| Code | Technical Reason |
+|---|---|
+| `MPC` | Program config not found |
+| `PRN` | Program not found |
+| `ZBD` | Zero balance client declined |
+
+## 12. Wallet payment failed, re-add card
+
+**Message shown to user:** *"Wallet payment failed. Re-add card and try again."*
+
+| Code | Technical Reason |
+|---|---|
+| `TNP` | Token not provided |
+| `Z26` | Card token not found |
+| `Z29` | Card token failed |
+| `Z30` | Token does not match card |
+
+## 13. Payment failed, check token status
+
+**Message shown to user:** *"Payment failed. Please check your token status."*
+
+| Code | Technical Reason |
+|---|---|
+| `Z22` | *(pending confirmation)* |
+
+## 14. Use PIN to complete transaction
+
+**Message shown to user:** *"Use PIN to complete transaction"*
+
+| Code | Technical Reason |
+|---|---|
+| `PNP` | *(pending confirmation)* |
+
+## 15. Invalid currency
+
+**Message shown to user:** *"Invalid currency. Contact support."*
+
+| Code | Technical Reason |
+|---|---|
+| `PIC` | *(pending confirmation)* |
+
+## 16. Transaction type not supported
+
+**Message shown to user:** *"Transaction type not supported. Please try again."*
+
+| Code | Technical Reason |
+|---|---|
+| `OON` | *(pending confirmation)* |
+
+## 17. Verification not completed
+
+**Message shown to user:** *"Verification not completed. Please try again."*
+
+| Code | Technical Reason |
+|---|---|
+| `NCV` | Entry mode not allowed with no-CVM |
+
+## 18. DCC not allowed
+
+**Message shown to user:** *"DCC not allowed"*
+
+| Code | Technical Reason |
+|---|---|
+| `MDC` | Multi-currency not allowed for DCC authorization |
+
+## 19. Installment not allowed
+
+**Message shown to user:** *"Installment not allowed"*
+
+| Code | Technical Reason |
+|---|---|
+| `ISE` | Insufficient statements |
+
+## 20. Mismatched account type
+
+**Message shown to user:** *"Mismatched Account type for this transaction"*
+
+| Code | Technical Reason |
+|---|---|
+| `IAT` | Invalid account type |
+
+## 21. Card type not supported
+
+**Message shown to user:** *"Card type not supported"*
+
+| Code | Technical Reason |
+|---|---|
+| `GCD` | Gift card denial |
+
+## 22. Payment method not accepted here
+
+**Message shown to user:** *"Payment method not accepted here."*
+
+| Code | Technical Reason |
+|---|---|
+| `FR5` | Magnetic stripe not allowed in this country |
+
+## 23. Other decline codes
+
+These codes fall outside the standard grouping (business, fraud, or card-status declines) and are shown with their own descriptive message directly.
+
+| Code | Message |
+|---|---|
+| `810` | Insufficient balance |
+| `CED` | Incorrect Exp Date, please check and retry |
+| `CNC` | Account cancelled |
+| `CND` | Account blocked |
+| `FL6` | Card blocked by anti-fraud |
+| `FR1` | CVV1 or CVC1 validation failed |
+| `FR2` | Incorrect CVV/CVC, please check and retry |
+| `FR6` | Password validation failed |
+| `PFT` | Do not honor |
+| `RED` | Operation not allowed. Contact support |
+| `TSM` | Password tries exceeded |
+| `UBN` | NFC disabled |
+| `VEV` | Expired virtual card |
+| `VNM` | Card expired |
+| `BND` | Card is cancelled |
+| `BNF` | Card flagged for fraud |
+| `BNM` | Card is damaged |
+| `BNP` | Card reported lost |
+| `BNR` | Card reported stolen |
+| `BNU` | Card is unreceived |
+| `CPE` | Card is in pending status |
+| `UBT` | Card is blocked |
diff --git a/concepts/card/overview.mdx b/concepts/card/overview.mdx
new file mode 100644
index 0000000..e6260e9
--- /dev/null
+++ b/concepts/card/overview.mdx
@@ -0,0 +1,39 @@
+---
+title: "Card Overview"
+description: "Understanding Gnosis Pay virtual cards, provisioning, and spending limits"
+---
+
+Gnosis Pay issues **virtual cards** that can be added to Apple Pay and Google Pay, letting users spend directly from their account without a physical card.
+
+## Card provisioning
+
+By default, each partner program is configured to issue **one virtual card per user**. This can be increased if a partner needs multiple cards per user — that's a configuration decided with the Gnosis Pay team during integration, not something set per-user at runtime.
+
+<Note>
+  If your program needs more than one card per user, this needs to be configured during integration. Contact our integration team to discuss.
+</Note>
+
+## Adding a card to a mobile wallet
+
+Once issued, a virtual card can be added to following with help of push provisioning:
+
+- **Apple Pay**
+- **Google Pay**
+
+This lets the user tap to pay with their phone or watch, without needing a physical card.
+
+## Card limit vs. account limit
+
+There are two distinct limits that govern how much a user can spend, and it's important not to conflate them:
+
+| | Card Limit | Account Limit |
+|---|---|---|
+| **What it governs** | Spending through a specific card | The account's total spendable balance |
+| **Default** | — | $10,000 |
+| **Who can configure it** | — | User (can set their own, stricter limit) or partner (can apply a custom limit up to the account's maximum) |
+
+The **account limit** is effectively a cap on spendable balance: by default this is set to **$10,000**, though a user can choose to set a *lower* limit on their own account and card for their own spending discipline
+
+<Info>
+  See [Account Overview](/concepts/accounts/account#account-spending-limits) for how account-level and partner-level limits interact.
+</Info>
diff --git a/concepts/card/transaction-enrichment.mdx b/concepts/card/transaction-enrichment.mdx
new file mode 100644
index 0000000..6ff17f4
--- /dev/null
+++ b/concepts/card/transaction-enrichment.mdx
@@ -0,0 +1,40 @@
+---
+title: "Transaction Enrichment"
+description: "How raw card transactions get enriched with merchant name, logo, and location data"
+---
+
+When a card transaction is authorized, the data that arrives from the card network is minimal and often cryptic, a raw merchant descriptor, an MCC code, sometimes a truncated or misspelled merchant name.
+
+**Transaction enrichment** is the process of matching that raw transaction data against a merchant database to attach richer, human-readable context such as the merchant's real name, logo, category, and location so partners can build a transaction history that actually looks like something a user recognizes, rather than a raw statement line.
+
+## Why this matters for the user experience
+
+Without enrichment, a transaction might show up as something like, when a user visits the transaction history:
+
+`SQ *COFFEE SHOP LLC 4155551234 CA`
+
+
+With enrichment, the same transaction can be shown as:
+
+- A recognizable **merchant name** ("Blue Bottle Coffee")
+- The merchant's **logo**
+- A **shop category** (e.g., "Coffee Shop") instead of a raw MCC code
+- The merchant's **location** including address, or map coordinates
+
+This is what lets partners build a transaction feed similar to what users expect from neobanks, rather than exposing raw network data.
+
+## How it works, conceptually
+
+When a transaction is authorized, Gnosis Pay attempts to match the raw merchant data against the service provider used for fetching the merchant database. This match either succeeds, partially succeeds, or fails — which is why enrichment carries a **status** alongside the merchant and shop data.
+
+## What gets enriched
+
+Broadly, enrichment can surface:
+
+- **Merchant identity**: name and logo
+- **Shop details**: category, tags, and merchant type
+- **Location**: street address, city, country, and map coordinates (where available)
+
+<Note>
+  Enrichment is applied automatically; there's nothing partners need to configure to receive enriched fields on a transaction.
+</Note>
diff --git a/concepts/intro.mdx b/concepts/intro.mdx
new file mode 100644
index 0000000..a806a7b
--- /dev/null
+++ b/concepts/intro.mdx
@@ -0,0 +1,42 @@
+---
+title: "Introduction to Gnosis Pay"
+description: "Stablecoin card-as-a-service infrastructure for wallets, neobanks, exchanges, and payment processors"
+---
+
+Gnosis Pay is a B2B stablecoin card program manager that enables fintech products like neobanks, wallets, etc to launch cards to users. Gnosis Pay Partners can run their own branded card programs and own their user relationships, while our platform handles the complexity of card network integrations, settlement flows, compliance, and payment processing.
+
+Partners can go further and customize their integration to fully own the end-to-end experience bringing their own KYC and user onboarding flows, or using the Gnosis Pay APIs directly to onboard users and issue cards.
+
+Gnosis Pay APIs are designed with developer experience who are integrating this in product. Developement team gets access to a dedicated sandbox environment, where they can test Visa transactions through the fully integrated Pismo Simulator, and run KYC flows.
+
+<Note>
+This documentation covers the guides for the product, alongside the full API reference.
+</Note>
+
+## Built for teams turning crypto into everyday finance
+
+<CardGroup cols={2}>
+  <Card title="Wallets" icon="wallet">
+    Turn DeFi into a daily financial hub with branded cards, auto-yield deposits, and real-world payments.
+  </Card>
+  <Card title="Neobanks" icon="building-columns">
+    Expand into new markets with one integration, offering local payment rails like SEPA, Pix, and Faster Payments — without needing local banking infrastructure.
+  </Card>
+  <Card title="Crypto Exchanges" icon="right-left">
+    With one API, exchanges enable users to spend USDC or EURC directly from their accounts via instant virtual cards that support retention and enhance utility.
+  </Card>
+  <Card title="Payment Processors" icon="credit-card">
+    Launch white-labeled card issuing with ease using your existing KYC/AML flow, in a fully branded experience.
+  </Card>
+</CardGroup>
+
+## What's next
+
+<CardGroup cols={2}>
+  <Card title="Understanding Gnosis Pay stack" icon="cube" href="/concepts/architecture">
+    Learn the core concepts and building blocks behind Gnosis Pay.
+  </Card>
+  <Card title="API Reference" icon="code" href="/api-reference/auth/get-siwe-message">
+    Explore endpoints to integrate cards, KYC, and payments.
+  </Card>
+</CardGroup>
diff --git a/concepts/kyc/kyc-overview.mdx b/concepts/kyc/kyc-overview.mdx
new file mode 100644
index 0000000..32b9870
--- /dev/null
+++ b/concepts/kyc/kyc-overview.mdx
@@ -0,0 +1,36 @@
+---
+title: "KYC Overview"
+description: "How identity verification works on Gnosis Pay, and what to expect during the process"
+---
+
+Before a user can be onboarded to Gnosis Pay, they must complete **Know Your Customer (KYC)** verification. This is a regulatory requirement for financial services — it confirms the user is who they say they are, checks eligibility (e.g., country of residence, age, sanctions/watchlist screening), and helps prevent fraud and financial crime on the platform.
+
+## We use Sumsub
+
+Gnosis Pay partners with **Sumsub** to handle identity verification. Sumsub collects and analyzes the user's identity documents (such as POA) and, depending on the flow, a liveness check to confirm the document belongs to the person submitting it.
+
+As a partner integrating Gnosis Pay, you don't build identity verification yourself — you embed the Sumsub iframe, and Gnosis Pay receives the verification result and status updates from Sumsub on your behalf.
+
+<Note>
+Gnosis Pay allows acceptance of sharing KYC of user from partner instance to Gnosis Pay instance and vice versa within SumsSub. To understand the flow, read [KYC Sharing (Sumsub Flow)](/integration_guides/kyc-sharing-sumsub-flow) guide to integrate this flow into your application.
+</Note>
+
+## KYC statuses
+
+As a user moves through verification, their KYC application passes through a series of statuses — from initial document collection, through automated and (where needed) manual review, to a final outcome.
+
+<Note>
+  See the full [KYC Statuses](/concepts/kyc/kyc-statuses) reference for what each status means, what the user experiences, and suggested user-facing messaging for each.
+</Note>
+
+## Country eligibility
+
+Not all countries of residence are eligible for registration. Eligibility depends on regulatory coverage and Gnosis Pay's supported jurisdictions.
+
+<Note>
+  See [countries of residence eligible for registration](https://kb.gnosispay.com/articles/7878909911-mandatory-info-countries-of-residence-eligible-for-registration) for the current list.
+</Note>
+
+## What's next
+
+Once KYC is approved, the user is moved to next onboarding state which is account provisioning and deploying a new safe on behalf of user.
diff --git a/concepts/kyc/kyc-statuses.mdx b/concepts/kyc/kyc-statuses.mdx
new file mode 100644
index 0000000..ec2fd3d
--- /dev/null
+++ b/concepts/kyc/kyc-statuses.mdx
@@ -0,0 +1,17 @@
+---
+title: "KYC Statuses"
+description: "Every status a user's KYC application can be in, what it means, and how to communicate it"
+---
+
+As a user moves through identity verification, Sumsub reports a status for their KYC application. The table below summarizes each status; details, suggested messaging, and escalation guidance follow.
+
+| Status | Action Required | What it means |
+|---|---|---|
+| **Documents Requested** | Yes | Sumsub is requesting documents from the user. Appears at the start of KYC and any time additional documentation is needed (e.g. Proof of Identity, Proof of Address). KYC cannot progress until documents are submitted. |
+| **Pending** | No | The user has submitted documents and Sumsub is performing automated analysis. Normal transitional status; most users move through it quickly. |
+| **Approved** | No | KYC verification is complete and the user is eligible to proceed to the next onboarding stage. Does not mean the account is fully active. |
+| **Resubmission Requested** | Yes | The submission was reviewed and resubmission is required. Common causes: expired documents, poor image quality, name mismatches, unsupported document types. |
+| **Requires Action** | Dependent on Gnosis Pay team | The application is queued for manual review by the compliance team. Common for higher-risk scores or when additional data is needed. Typically resolves within 24 hours (up to 3–5 business days). |
+| **Rejected** | Final status | The application has been permanently rejected. Cannot be resubmitted by the user or reversed by the partner; only Gnosis Pay can manually review a possible error. |
+
+---
diff --git a/concepts/safe/overview.mdx b/concepts/safe/overview.mdx
new file mode 100644
index 0000000..4c75d7d
--- /dev/null
+++ b/concepts/safe/overview.mdx
@@ -0,0 +1,53 @@
+---
+title: "GP Safe Account"
+description: "Understanding Gnosis Pay Safe account architecture and modules"
+---
+
+Gnosis Pay's on-chain infrastructure is built on top of the Safe protocol, providing a secure and programmable foundation for digital payments. Each user receives a unique Safe account that acts as their on-chain wallet, with additional modules that enable spending limits, time delays, and delegated spending capabilities.
+
+## Architecture Overview
+
+The Gnosis Pay Safe consists of a core Safe account with three main modules:
+
+- **Core Safe Account**: The base Safe wallet that holds funds and processes transactions
+- **Delay Module**: Controls transaction timing and provides security delays
+- **Roles Module**: Manages spending permissions and allowance limits
+
+
+### Instant Withdrawals
+Withdrawals from the Gnosis Pay Safe reduce the spendable balance immediately to avoid double spending and then sync with the on-chain balance. During this process, the card is not blocked from operations.
+
+### Multi-Currency Support
+The Roles module now supports multi-token configurations so that users can spend different currencies via their spending safe.
+
+## Module Configurations:
+
+### Delay Module Settings
+- **Transaction delay**: 25 hours
+- **Transaction expiration**: 31 hours
+
+<Warning>
+These extended timeouts are designed to discourage direct delay module interaction. Failed transactions require the full expiration period before they can be skipped.
+</Warning>
+
+### Daily onchain spending limits
+
+The Roles module enforces a hardcoded on-chain limit of **\$20K per token***, twice the card limit. This buffer exists because card clearing and settlement can take 1–4 days after a transaction, and the higher on-chain limit ensures uninterrupted card operations over that window without requiring any additional user signatures.
+
+
+<Warning>
+    Any interaction with the delay module will block the card and require customer support intervention to resolve the issue.
+</Warning>
+
+
+
+## Account balances state breakdown for authenticated user
+
+Gnosis Pay provides detailed balance breakdowns to give users complete visibility into their fund status. The authenticated user's account displays four distinct balance types:
+
+| Balance Type | Description | Increases When | Decreases When |
+|--------------|-------------|----------------|----------------|
+| **Spendable** | Amount available for immediate spending via card transactions or withdrawals | • Deposits clear AML analysis<br/>• Refunds are processed<br/>• Returns of goods are credited | • Card transactions are authorized<br/>• Withdrawals are initiated |
+| **Non-Spendable** | Funds that cannot be used for spending. Flagged for review or potential return | • Dependent on AML checks | • Funds are returned to source<br/>• Funds are manually released after review |
+| **Processing Deposits** | Incoming deposits currently undergoing AML analysis. Not yet available for spending | • New deposit is received | • AML analysis completes (moves to spendable or non-spendable) |
+| **Processing Withdrawals** | Outgoing withdrawals currently being processed. Deducted from spendable but not yet settled on-chain | • Withdrawal is initiated | • Withdrawal settles on-chain |
diff --git a/concepts/safe/tokens-and-chains-supported.mdx b/concepts/safe/tokens-and-chains-supported.mdx
new file mode 100644
index 0000000..17298c1
--- /dev/null
+++ b/concepts/safe/tokens-and-chains-supported.mdx
@@ -0,0 +1,25 @@
+---
+title: "Tokens and Chains Supported"
+description: "Supported chains and the tokens available for Gnosis Pay accounts on each"
+---
+
+Gnosis Pay accounts can be provisioned with tokens across the following chains.
+
+## Celo
+
+| Token | Contract Address |
+|---|---|
+| USDC | `0xceba9300f2b948710d2653dd7b07f33a8b32118c` |
+| USDT | `0x48065fbbe25f71c9282ddf5e1cd6d6a887483d5e` |
+
+## Gnosis Chain
+
+| Token | Contract Address |
+|---|---|
+| EURe | `0xcB444e90D8198415266c6a2724b7900fb12FC56E` |
+| GBPe | `0x5Cb9073902F2035222B9749F8fB0c9BFe5527108` |
+| USDCe | `0x2a22f9c3b484c3629090FeED35F17Ff8F88f76F0` |
+
+<Note>
+   [Contact sales] to support custom chain or custom token for your integration.
+</Note>
diff --git a/concepts/whybuild.mdx b/concepts/whybuild.mdx
new file mode 100644
index 0000000..764bd38
--- /dev/null
+++ b/concepts/whybuild.mdx
@@ -0,0 +1,78 @@
+---
+title: "Why Build with Gnosis Pay"
+description: "What you get as a partner from user onboading to launching a full fledged card program"
+---
+Gnosis Pay gives you the infrastructure to launch a card program and the flexibility to run it your way. Here's what that means in practice, for your business and for your engineering team.
+
+## For your business
+
+### Onboarding
+
+<Card title="KYC sharing" icon="id-card">
+  Already onboard your users with Sumsub? Integrate that flow directly and share KYC into Gnosis Pay. Your users complete verification once, no duplicate KYC to get a card.
+</Card>
+
+### Multi-chain and multi-currency
+
+<CardGroup cols={3}>
+  <Card title="Multi-chain" icon="link">
+    Launch your card program on the chains you choose. We support the underlying infrastructure across multiple chains. Gnosis Pay infra is live on Celo and Gnosis Chain.
+  </Card>
+  <Card title="Multi-stablecoin" icon="coins">
+    Enable your ecosystem's stablecoin as a spending currency, fully on-chain with native support. A single card can hold and spend multiple tokens.
+  </Card>
+  <Card title="Multi-currency accounts" icon="money-bill-transfer">
+    Multi-currency cards (e.g. EUR, USD, GBP) can be enabled for your program if you want to offer it to users, subject to pricing.
+  </Card>
+</CardGroup>
+
+### Money movement
+
+<CardGroup cols={2}>
+  <Card title="Instant withdrawals" icon="bolt">
+    Fully self-custodial. Withdraw your balance instantly — no lock-up periods, no settlement delays.
+  </Card>
+  <Card title="Instant reversals" icon="rotate-left">
+    Reversals are processed the moment we receive the message from the network. Funds return to the user's balance immediately, with no manual step in between.
+  </Card>
+</CardGroup>
+
+### Fees Customization
+
+<CardGroup cols={2}>
+  <Card title="Custom card design" icon="paintbrush">
+    Design your own cards to match your brand (subject to Visa's approval timeline).
+  </Card>
+  <Card title="Custom markup" icon="percent">
+    Add your own markup on top of transactions.
+  </Card>
+  <Card title="Custom limits" icon="sliders">
+    Set account- and card-level spending limits per user.
+  </Card>
+  <Card title="Flexible integration" icon="puzzle-piece">
+    Shape the program to your product from onboarding to card controls.
+  </Card>
+</CardGroup>
+
+### Payments experience
+
+<Card title="Apple Pay & Google Pay" icon="mobile">
+  Provision cards to Apple Pay and Google Pay so users can tap to pay from day one.
+</Card>
+
+## For developers and product teams
+
+<CardGroup cols={2}>
+  <Card title="Partner Dashboard" icon="gauge">
+    Configure webhooks and PSE setup, and access analytics and user data so your team can own communications and user relationships directly.
+  </Card>
+  <Card title="Sandbox environment" icon="flask">
+    A full sandbox to build and test against before going to production, including transaction simulations.
+  </Card>
+  <Card title="Real-time webhooks" icon="bell">
+    Subscribe to real-time events to power user notifications and keep your systems in sync.
+  </Card>
+  <Card title="Integration support" icon="headset">
+    Technical integration support available throughout your build.
+  </Card>
+</CardGroup>
diff --git a/docs.json b/docs.json
index 607aaff..b1293aa 100644
--- a/docs.json
+++ b/docs.json
@@ -1,106 +1,140 @@
 {
+  "$schema": "https://mintlify.com/docs.json",
   "theme": "mint",
-  "name": "Gnosis Pay Documentation",
+  "name": "Gnosis Pay",
   "colors": {
-    "primary": "#707A2D",
-    "light": "#D8EB81",
-    "dark": "#919E3A"
+    "primary": "#766DE5",
+    "light": "#9994ED",
+    "dark": "#1A1751"
+  },
+  "appearance": {
+    "default": "light",
+    "strict": false
+  },
+  "logo": {
+    "light": "/static/img/logo-dark.svg",
+    "dark": "/static/img/logo-light.svg"
+  },
+  "navbar": {
+    "links": [
+      {
+        "label": "Contact Sales team",
+        "href": "https://form.typeform.com/to/naN3irHW?typeform-source=gnosispay.com"
+      }
+    ],
+    "primary": {
+      "type": "button",
+      "label": "Sign up as Partner",
+      "href": "https://partner-dashboard.sandbox.gnosispay.com/auth/signin"
+    }
   },
-  "favicon": "/static/img/favicon.ico",
   "navigation": {
     "tabs": [
       {
-        "tab": "Guides",
+        "tab": "Concepts",
         "groups": [
           {
-            "group": "Introduction to Gnosis Pay",
-            "icon": "play",
-            "pages": ["index", "integration-model", "auth", "onboarding-flow"]
+            "group": "Welcome to Gnosis Pay",
+            "pages": [
+              "concepts/intro",
+              "concepts/whybuild",
+              "concepts/architecture"
+            ]
+          },
+          {
+            "group": "Authentication",
+            "pages": ["concepts/auth/token"]
+          },
+          {
+            "group": "KYC",
+            "pages": ["concepts/kyc/kyc-overview", "concepts/kyc/kyc-statuses"]
           },
           {
             "group": "Accounts",
-            "icon": "user",
             "pages": [
-              "account",
-              "account/update-authenticated-account",
-              "account/adding-safe-owner"
+              "concepts/accounts/account",
+              "concepts/accounts/account-status"
             ]
           },
           {
-            "group": "On/Off Ramps",
-            "icon": "landmark",
+            "group": "Safe & Modules",
             "pages": [
-              "on-off-ramps/index",
-              "on-off-ramps/iban-integration",
-              "on-off-ramps/kyc-sharing"
+              "concepts/safe/overview",
+              "concepts/safe/tokens-and-chains-supported"
             ]
           },
           {
             "group": "Cards",
-            "icon": "credit-card",
             "pages": [
-              "cards/concepts",
-              "cards/create-physical-cards",
-              "cards/create-virtual-cards",
-              "cards/card-order-state-transitions",
-              "cards/pse-integration"
+              "concepts/card/overview",
+              "concepts/card/decline-codes",
+              "concepts/card/transaction-enrichment"
             ]
+          }
+        ]
+      },
+      {
+        "tab": "Integration Guide",
+        "groups": [
+          {
+            "group": "Getting started",
+            "pages": ["guides/configuring-environment"]
           },
           {
-            "group": "Card Transactions",
-            "icon": "receipt",
+            "group": "Authentication & Onboarding",
+            "pages": ["guides/auth-with-siwe", "guides/onboarding"]
+          },
+          {
+            "group": "KYC Sharing",
             "pages": [
-              "transactions/index",
-              "transactions/lifecycle",
-              "transactions/integration-guide"
+              "guides/kyc-sharing/pass-kyc",
+              "guides/kyc-sharing/monerium"
             ]
           },
           {
-            "group": "On-chain",
-            "icon": "cubes",
+            "group": "Manage Accounts",
             "pages": [
-              "gp-onchain/overview",
-              "gp-onchain/about-GP-safe",
-              "gp-onchain/sign-message",
-              "gp-onchain/daily-limit",
-              "gp-onchain/withdraw-funds-from-safe",
-              "gp-onchain/third-party-bridges"
+              "guides/accounts/manage-accounts",
+              "guides/accounts/limits",
+              "guides/accounts/account-statement",
+              "guides/accounts/onchain-withdrawal"
             ]
           },
           {
-            "group": "Webhooks",
-            "icon": "webhook",
+            "group": "Manage Cards",
             "pages": [
-              "webhooks/introduction",
-              "webhooks/getting-started",
-              "webhooks/events"
+              "guides/cards/create-virtual",
+              "guides/cards/card-limit",
+              "guides/cards/card-simulator"
             ]
-          }
-        ]
-      },
-      {
-        "tab": "API reference",
-        "groups": [
-          {
-            "group": "Authentication",
-            "pages": ["api-reference/intro", "api-reference/auth-app"]
           },
           {
-            "group": "API reference",
-            "openapi": "https://api.gnosispay.com/api-docs/spec.json"
+            "group": "Secure Card Elements via PSE",
+            "pages": ["guides/pse/pse", "guides/pse/pse-integration"]
           },
           {
-            "group": "PSE API",
-            "openapi": "https://api-pse-public.gnosispay.com/api-docs/spec.json"
+            "group": "Webhooks",
+            "pages": [
+              "guides/webhooks/webhook",
+              "guides/webhooks/webhook-events"
+            ]
           }
         ]
+      },
+      {
+        "tab": "API Reference",
+        "openapi": "https://core.prod.gnosispay.com/user-api/openapi.json"
+      },
+      {
+        "tab": "Migration",
+        "pages": ["migration/migration-overview"]
+      },
+      {
+        "tab": "Changelog",
+        "pages": ["changelog/index"]
       }
     ]
   },
-  "logo": {
-    "light": "/static/img/Logo-black.svg",
-    "dark": "/static/img/Logo-white.svg"
-  },
   "contextual": {
     "options": [
       "copy",
diff --git a/gp-onchain/about-GP-safe.mdx b/gp-onchain/about-GP-safe.mdx
deleted file mode 100644
index de4ffb7..0000000
--- a/gp-onchain/about-GP-safe.mdx
+++ /dev/null
@@ -1,58 +0,0 @@
----
-title: About GP Safe
-description: Gnosis Pay's on-chain infrastructure is built on top of the [Safe protocol](https://safe.global), providing a secure and programmable foundation for digital payments. Each user gets a unique Safe account that acts as their on-chain wallet, with additional modules that enable spending limits, time delays, and delegated spending capabilities.
----
-
-The Gnosis Pay Safe consists of a core Safe account with three main modules attached:
-
-1. **Core Safe Account**: The base Safe that holds funds and manages ownership
-2. **Delay Module**: Controls transaction timing and provides security delays
-3. **Roles Module**: Manages spending permissions and allowance limits
-4. **Bouncer Module**: Handles account access validation and security
-
-### Gnosis Pay Safe Setup Process
-
-To understand how a Gnosis Pay Safe differs from a standard Safe, let's examine the [account setup flow](https://github.com/gnosispay/account-kit/blob/main/src/entrypoints/accounts-actions/accountSetup.ts#L88) that transforms a basic 1/1 Safe into a fully configured Gnosis Pay Safe Account:
-
-<Steps titleSize="h3">
-<Step title="Safe Configuration">
-- **Ownership Transfer**: Swaps the Safe owner to an inaccessible address (`0x0000000000000000000000000000000000000002`)
-- **Module Enablement**: Enables both the Roles and Delay modules on the Safe
-</Step>
-
-<Step title="Delay Module Setup">
-- **Deployment**: Creates a new Delay module instance for the account
-- **Cooldown Configuration**: Sets the transaction delay period (typically 3 minutes)
-- **Expiration Setting**: Configures how long queued transactions remain valid
-- **Owner Access**: Grants the initial Safe owner (the owner before the ownership transfer) access to the delay module
-</Step>
-
-<Step title="Roles Module Setup">
-- **Deployment**: Creates a new Roles module instance for the account
-- **Allowance Configuration**: Sets up spending limits with:
-  - Initial balance amount
-  - Maximum balance cap
-  - Refill amount per period
-  - Time period for refills
-- **Role Assignment**: Grants spending permissions to designated spender addresses
-- **Target Scoping**: Restricts spending to specific token contracts
-- **Function Scoping**: Limits operations to ERC20 transfer functions only
-- **Ownership Transfer**: Transfers control to the Bouncer module
-</Step>
-
-<Step title="Bouncer Module">
-- **Deployment**: Creates the final security layer
-- **Access Control**: Manages who can interact with the account
-</Step>
-</Steps>
-
-### Spending Control Flow
-
-The spending process follows this pattern:
-
-1. **Spender Request**: A designated spender requests a transaction
-2. **Allowance Check**: The Roles module verifies spending limits
-3. **Delay Enforcement**: If limits allow, the transaction enters the delay queue
-4. **Time Delay**: The transaction waits for the configured cooldown period
-5. **Execution**: After the delay, the transaction can be executed
-6. **Balance Update**: The allowance balance is updated accordingly
diff --git a/gp-onchain/daily-limit.mdx b/gp-onchain/daily-limit.mdx
deleted file mode 100644
index 6dc9ebf..0000000
--- a/gp-onchain/daily-limit.mdx
+++ /dev/null
@@ -1,174 +0,0 @@
----
-title: "Change GP Safe daily spending limit"
-description: "Manage daily spending limits for Gnosis Pay Safe accounts"
----
-
-The daily spending limit feature allows partners to manage daily spending limits for Gnosis Pay Safe accounts.
-
-All transactions are gasless, enabling users to perform these operations completely free of charge.
-
-## Overview
-
-The daily spending limit update process involves the following steps:
-
-1. **Fetch EIP-712 Typed Data** - Get the EIP-712 typed data for wallet signing
-2. **Sign and Submit** - Sign the EIP-712 data and submit the update
-3. **Monitor Update** - Wait for the delay relay to process the change and check the new limit
-
-<Warning>
-- The signing wallet must be one of the Gnosis Pay Safe signers (EOA or smart contract wallet)
-- For smart contract wallets, signatures are verified using ERC-1271 standard
-- Updates are processed after a 3-minute delay as transactions are going through the Gnosis Pay delay relay
-</Warning>
-
-## Daily Limit Update Process
-
-<Steps titleSize="h3">
-<Step title="Fetch EIP-712 Typed Data for Signing">
-
-[Get the EIP-712 typed data that needs to be signed by the user's wallet](/api-reference/account-management/get-eip-712-typed-data-for-setting-daily-limit):
-
-```bash cURL
-curl -X GET \
- /api/v1/accounts/daily-limit/transaction-data?newLimit=${newLimit}
-```
-
-The response contains EIP-712 typed data with `domain`, `types`, `primaryType`, and `message` fields that need to be signed by the user's wallet using the EIP-712 standard.
-</Step>
-<Step title="Sign and Submit EIP-712 Data">
-
-<Warning>
-**Safe Activation Required**: This step only works when the Gnosis Pay Safe account has been fully activated and its modules are deployed. If you receive an error during submission, ensure that the Safe account activation process has been completed first.
-
-For more information about Safe account setup and module deployment, see the [Safe Management API documentation](/api-reference/safe-management/deploy-and-setup-a-safe).
-</Warning>
-
-The EIP-712 typed data from Step 1 must be signed by the user's wallet using the EIP-712 signature standard.
-
-<Note>
-**Wallet Requirements:**
-- The wallet must be a signer of the Gnosis Pay Safe account
-- For **EOA wallets**: Standard EIP-712 signature is used
-- For **smart contract wallets**: ERC-1271 signature verification is used, and you must include the `smartWalletAddress` field in the request body
-</Note>
-
-Once signed, [submit the transaction to update the daily limit](/api-reference/account-management/set-new-daily-spending-limit):
-
-
-```bash cURL
-# For EOA wallets
-curl -X PUT /api/v1/accounts/daily-limit \
- -d '{
-  "newLimit": 1500,
-  "signature": "0x...",
-  "message": {
-    "salt": "0x...",
-    "data": "0x..."
-  }
-}'
-
-# For smart contract wallets (include smartWalletAddress)
-curl -X PUT /api/v1/accounts/daily-limit \
- -d '{
-  "newLimit": 1500,
-  "signature": "0x...",
-  "message": {
-    "salt": "0x...",
-    "data": "0x..."
-  },
-  "smartWalletAddress": "0x..."
-}'
-```
-
-</Step>
-<Step title="Monitor the Transaction Execution">
-
-The daily limit change is processed through a delay relay mechanism that executes after 3 minutes.
-
-You can monitor the transaction status using the [delay-relay monitoring endpoint](/api-reference/safe-management/list-delayed-transactions)
-or by checking your Safe's transaction history.
-
-Additionally, you can also [poll the following endpoint to check when the new limit becomes active](/api-reference/account-management/get-current-daily-spending-limit):
-
-
-```bash cURL
-curl -X GET /api/v1/accounts/daily-limit
-```
-
-</Step>
-</Steps>
-
-## Complete Implementation Example
-
-The following example demonstrates the complete flow:
-
-```typescript
-
-const newDailyLimit = 1337;
-
-/**
- * Step 1: Fetch EIP-712 typed data for signing
- */
-const response = await fetch(
-  `https://api.gnosispay.com/api/v1/accounts/daily-limit/transaction-data?newLimit=${newDailyLimit}`
-);
-const { data: typedData } = await response.json();
-
-/**
- * Step 2: Sign the EIP-712 typed data
- */
-const signature = await walletClient.signTypedData({
-  ...typedData,
-  domain: {
-    ...typedData.domain,
-    verifyingContract: typedData.domain.verifyingContract as `0x${string}`,
-  },
-});
-
-/**
- * Step 3: Submit the signed data
- */
-const submitResponse = await fetch("https://api.gnosispay.com/api/v1/accounts/daily-limit", {
-  method: "PUT",
-  headers: { "Content-Type": "application/json" },
-  body: JSON.stringify({
-    newLimit: newDailyLimit,
-    signature,
-    message: typedData.message,
-    // Include smartWalletAddress if using a smart contract wallet
-    // smartWalletAddress: "0x...",
-  }),
-});
-
-const { data: updateResult } = await submitResponse.json();
-
-/**
- * Step 4: Monitor for the updated limit
- */
-console.log(`Daily limit update submitted with ID: ${updateResult.id}`);
-console.log(`Status: ${updateResult.status}`);
-console.log("Limit change will be processed after the 3-minute delay period");
-
-// Optional: Poll for the updated limit
-const pollForUpdate = async () => {
-  const checkResponse = await fetch(
-    "https://api.gnosispay.com/api/v1/accounts/daily-limit"
-  );
-  const { data: { dailyLimit: updatedLimit } } = await checkResponse.json();
-
-  if (updatedLimit === newDailyLimit) {
-    console.log(`Limit successfully updated to: ${updatedLimit}`);
-    return true;
-  }
-
-  console.log(`Waiting for update... Current: ${updatedLimit}, Target: ${newDailyLimit}`);
-  return false;
-};
-
-// Poll every 30 seconds until the update is complete
-const interval = setInterval(async () => {
-  if (await pollForUpdate()) {
-    clearInterval(interval);
-  }
-}, 30000);
-```
diff --git a/gp-onchain/overview.mdx b/gp-onchain/overview.mdx
deleted file mode 100644
index 978fb0c..0000000
--- a/gp-onchain/overview.mdx
+++ /dev/null
@@ -1,24 +0,0 @@
----
-title: Overview
-description: Understanding the on-chain integration options for Gnosis Pay, including the Account Kit SDK and direct contract integration approaches.
---- 
-
-## Account Kit 
-
-We provide the Account Kit as a way to accelerate on-chain integration for the TypeScript/JavaScript ecosystem. This SDK abstracts away the complexity of our multi-module Safe architecture, making it easier for developers to integrate with Gnosis Pay's on-chain infrastructure directly.
-
-Installing instructions and comprehensive examples are available in the [Account Kit repository](https://github.com/gnosispay/account-kit). The SDK is open source and actively maintained by the Gnosis Pay team.
-
-All examples in this section of the documentation assume you are using the Account Kit SDK.
-
-## Direct Integration without Account Kit 
-
-For other programming languages, you can use their own cryptocurrency libraries (e.g., go-ethereum for Go, web3.py for Python, and so on) and integrate directly with the contracts. However, this approach requires additional steps since the Account Kit relies on TypeScript/JavaScript projects from Gnosis such as `@gnosis.pm/safe-contracts`, `@gnosis.pm/zodiac`, and related dependencies.
-
-Integrating directly means you'll need to explore the Account Kit source code and its dependencies to understand:
-- **Contract Function Calls**: Which specific functions are being called on the Safe, Delay, Roles, and Bouncer modules
-- **Payload Encoding**: How transaction data is encoded and structured for each operation
-- **Module Interactions**: The sequence and coordination between different modules
-- **Parameter Validation**: What parameters are required and how they're validated
-
-This reverse-engineering approach is entirely doable for teams with strong smart contract integration experience, but it requires significant additional development time compared to using the Account Kit directly. 
\ No newline at end of file
diff --git a/gp-onchain/sign-message.mdx b/gp-onchain/sign-message.mdx
deleted file mode 100644
index f88d8a0..0000000
--- a/gp-onchain/sign-message.mdx
+++ /dev/null
@@ -1,92 +0,0 @@
----
-title: Sign Messages with GP Safe
-description: Learn how to sign messages using your GP Safe account with the delay module for enhanced security.
----
-
-Unlike traditional EOA (Externally Owned Account) message signing, GP Safe message signing goes through the delay module.
-
-<Note>
-Message signing with GP Safe requires the account to be fully configured with the delay module enabled. If you haven't set up your Safe account yet, see the [Safe Account Configuration](/onboarding-flow#4-safe-account-configuration) section first.
-</Note>
-
-## Message Signing Process
-
-GP Safe message signing follows the same two-phase pattern as other delayed operations:
-
-1. **Enqueue Phase**: Submit the message signing request to the delay queue
-2. **Dispatch Phase**: Execute the message signing after the delay period expires
-
-[You can find a complete working example here.](https://github.com/gnosispay/account-kit/blob/main/examples/src/sign-safe-message/index.ts)
-
-<Steps titleSize="h3">
-<Step title="Prepare the Message">
-First, prepare the message you want to sign. 
-
-This can be any string, such as: 
-
-```typescript
-const message = "Hello, this is a message to be signed by my GP Safe!";
-```
-
-Or structured data that needs to be signed by your GP Safe account. 
-
-</Step>
-
-<Step title="Enqueue the Message Signing Request">
-Use the `populateSignMessageEnqueue` function to create a transaction that submits your message signing request to the delay queue.
-
-```typescript
-import { populateSignMessageEnqueue } from "@gnosispay/account-kit";
-
-const owner: Signer = {}; // Your wallet signer
-const account = "0x..."; // Your GP Safe address
-const chainId = 100; // Gnosis Chain
-
-const enqueueTx = await populateSignMessageEnqueue(
-  { account, chainId },
-  message,
-  // EIP-712 signature callback
-  ({ domain, primaryType, types, message }) =>
-    owner.signTypedData(domain, primaryType, types, message)
-);
-
-// Send the enqueueTx using your wallet
-```
-
-<Warning>
-This transaction will be queued in the delay module and cannot be executed immediately. The delay period (typically 3 minutes) must pass before the message can be signed.
-</Warning>
-</Step>
-
-<Step title="Wait for the Delay Period">
-The message signing request is now in the delay queue. You must wait for the configured cooldown period to expire before proceeding.
-
-<Info>
-The default delay period is 3 minutes (180 seconds). This provides time for you to review and potentially cancel the operation if needed.
-</Info>
-
-You can check the delay queue status using the `accountQuery` function from `@gnosispay/account-kit`.
-
-</Step>
-
-<Step title="Dispatch the Message Signing">
-Once the delay period has expired, use the `populateSignMessageDispatch` function to execute the queued message signing operation.
-
-```typescript
-import { populateSignMessageDispatch } from "@gnosispay/account-kit";
-
-const dispatchTx = populateSignMessageDispatch(
-  { account },
-  message
-);
-
-// Send the dispatchTx using your wallet
-```
-
-<Note>
-Unlike the enqueue transaction, the dispatch transaction doesn't require a signature since it's executing a previously authorized operation.
-</Note>
-</Step>
-</Steps>
-
-
diff --git a/gp-onchain/third-party-bridges.mdx b/gp-onchain/third-party-bridges.mdx
deleted file mode 100644
index 4b6f45e..0000000
--- a/gp-onchain/third-party-bridges.mdx
+++ /dev/null
@@ -1,56 +0,0 @@
----
-title: "Third-Party Bridges"
----
-Gnosis Pay partners can select and integrate bridge aggregators based on their specific infrastructure requirements and target chain support. The following recommended solutions ensure optimal cross-chain functionality for end users.
-
-
-### Recommended Bridge Aggregators
-
-<CardGroup cols={2}>
-
-  <Card
-    title="NEAR Intents"
-    icon="link"
-    href="https://docs.near-intents.org"
-    color="#00d4aa"
-  >
-     Intent-based bridging with deep liquidity for Gnosis Chain, supporting EURe and GBPe. Converts Bitcoin and non-EVM assets to Gnosis Chain in a single transaction.
-  </Card>
-
-  <Card
-    title="Bungee Exchange"
-    icon="bridge"
-    href="https://docs.bungee.exchange/bungee-api/"
-    color="#6366f1"
-  >
-    Cross-chain bridge aggregator offering best-price, auto-routed swaps across multiple blockchains.
-  </Card>
-
-  <Card
-    title="LiFi Protocol"
-    icon="bridge"
-    href="https://docs.li.fi/introduction/introduction"
-    color="#6366f1"
-  >
-    Cross-chain liquidity aggregation protocol enabling seamless token transfers across multiple chains and bridges.
-  </Card>
-
-  <Card
-    title="CoW Swap"
-    icon="cow"
-    href="https://docs.cow.fi/"
-    color="#16a34a"
-  >
-    Native Gnosis Chain protocol offering MEV-protected, gasless bridging from Ethereum.
-  </Card>
-
-  <Card
-    title="deBridge"
-    icon="rainbow"
-    href="https://docs.debridge.com/"
-    color="#ec4899"
-  >
-    Handles complex cross-chain routes like Solana USDC → Gnosis with custom message passing.
-  </Card>
-
-</CardGroup>
diff --git a/gp-onchain/withdraw-funds-from-safe.mdx b/gp-onchain/withdraw-funds-from-safe.mdx
deleted file mode 100644
index e14b640..0000000
--- a/gp-onchain/withdraw-funds-from-safe.mdx
+++ /dev/null
@@ -1,162 +0,0 @@
----
-title: "Withdraw funds from GP Safe"
-description: "How to send funds from the Gnosis Pay Safe to your EOA or somewhere else."
----
-
-The withdrawal feature allows partners to withdraw tokens from Gnosis Pay Safe accounts to any external address **on the Gnosis Chain**.
-All transactions are gasless, enabling users to perform these operations completely free of charge.
-
-The withdrawal process involves the following steps:
-
-1. **Fetch Transaction Data** - Get the EIP-712 typed data for signing
-2. **Sign and Submit** - Sign the transaction and submit the withdrawal
-3. **Monitor Execution** - Wait for the delay relay to process the withdrawal
-
-<Warning>
-Please remember the following:
-- The signing wallet must be one of the Gnosis Pay Safe signers (EOA or smart contract wallet)
-- For smart contract wallets, signatures are verified using ERC-1271 standard
-- Withdrawals are processed after a 3-minute delay as transactions are going through the Gnosis Pay delay relay
-- Cards are temporarily frozen for 3 minutes during withdrawal processing as a security measure
-</Warning>
-
-## Withdrawal Process
-
-<Steps titleSize="h3">
-<Step title="Fetch Transaction Data for Signing">
-
-Get the EIP-712 typed data that needs to be signed by the user's wallet [(spec)](/api-reference/account-management/retrieve-transaction-data-for-withdrawing-from-safe):
-
-```bash cURL
-curl -X GET \
-/api/v1/accounts/withdraw/transaction-data?tokenAddress=${tokenAddress}&to=${toAddress}&amount=${amount}
-```
-
-The response contains EIP-712 typed data that needs to be signed by the user's wallet.
-
-</Step>
-<Step title="Sign the EIP-712 Typed Data">
-The EIP-712 typed data from Step 1 must be signed by the user's wallet using the EIP-712 signature standard.
-
-<Note>
-**Wallet Requirements:**
-- The wallet must be a signer of the Gnosis Pay Safe account
-- For **EOA wallets**: Standard EIP-712 signature is used
-- For **smart contract wallets**: ERC-1271 signature verification is used, and you must include the `smartWalletAddress` field in the request body
-</Note>
-</Step>
-<Step title="Submit Transaction">
-
-Once signed, [submit the transaction to execute the withdrawal](/api-reference/account-management/withdraw-from-safe-with-signature):
-
-```bash cURL
-# For EOA wallets
-curl -X POST \
-/api/v1/accounts/withdraw \
--H "Content-Type: application/json" \
--d '{
-  "tokenAddress": "0x123456....",
-  "to": "0x78910...",
-  "amount": "1000000000000000000",
-  "signature": "0x1234567890abcdef...",
-  "message": {
-    "salt": "0x1234567890...abcdef",
-    "data": "0x123456...00de0b6b3a7640000"
-  }
-}'
-
-# For smart contract wallets (include smartWalletAddress)
-curl -X POST \
-/api/v1/accounts/withdraw \
--H "Content-Type: application/json" \
--d '{
-  "tokenAddress": "0x123456....",
-  "to": "0x78910...",
-  "amount": "1000000000000000000",
-  "signature": "0x1234567890abcdef...",
-  "message": {
-    "salt": "0x1234567890...abcdef",
-    "data": "0x123456...00de0b6b3a7640000"
-  },
-  "smartWalletAddress": "0x..."
-}'
-```
-
-</Step>
-<Step title="Monitor the Execution">
-
-The withdrawal is processed through a **delay relay mechanism** that executes after 3 minutes.
-
-You can monitor the transaction status using the [delay-relay monitoring endpoints](/api-reference/safe-management/list-delayed-transactions) or by checking your Safe's transaction history.
-</Step>
-</Steps>
-
-
-
-
-## Complete Implementation Example
-
-The following example demonstrates the complete flow:
-
-```typescript
-const tokenAddress = "0x..."; // Token contract address
-const toAddress = "0x..."; // Destination address
-const amount = "1000000000000000000"; // Amount in token base units
-
-/**
- * Step 1: Fetch transaction data for signing
- */
-const response = await fetch(
-  `https://api.gnosispay.com/api/v1/accounts/withdraw/transaction-data?tokenAddress=${tokenAddress}&to=${toAddress}&amount=${amount}`
-);
-const { data: typedData } = await response.json();
-
-/**
- * Step 2: Sign and submit the transaction
- */
-const signature = await walletClient.signTypedData({
-  ...typedData,
-  domain: {
-    ...typedData.domain,
-    verifyingContract: typedData.domain.verifyingContract as `0x${string}`,
-  },
-});
-
-const submitResponse = await fetch("https://api.gnosispay.com/api/v1/accounts/withdraw", {
-  method: "POST",
-  headers: { "Content-Type": "application/json" },
-  body: JSON.stringify({
-    tokenAddress,
-    to: toAddress,
-    amount,
-    signature,
-    message: typedData.message,
-    // Include smartWalletAddress if using a smart contract wallet
-    // smartWalletAddress: "0x...",
-  }),
-});
-
-const { data: transactionResult } = await submitResponse.json();
-
-/**
- * Step 3: Monitor execution (optional)
- */
-console.log(`Withdrawal submitted with ID: ${transactionResult.id}`);
-console.log(`Status: ${transactionResult.status}`);
-console.log("Transaction will be processed after the 3-minute delay period");
-```
-
-
-## Security Considerations
-
-- Make sure the user is aware this transfer is on the Gnosis Chain
-- Remember that transactions cannot be reversed once executed
-- Cards are temporarily frozen during the withdrawal process as a security measure
-
-## Token Support
-
-This feature supports withdrawing any ERC-20 token that exists in the Safe account. Make sure to:
-
-- Use the correct token contract address
-- Specify the amount in the token's base units (considering decimals)
-- Ensure sufficient token balance in the Safe account
diff --git a/guides/accounts/account-statement.mdx b/guides/accounts/account-statement.mdx
new file mode 100644
index 0000000..3adabbc
--- /dev/null
+++ b/guides/accounts/account-statement.mdx
@@ -0,0 +1,57 @@
+---
+title: "Account Statements"
+description: "Retrieve account statements for users"
+---
+
+## Retrieve Account Statement
+
+An account statement is a chronological record of all financial activity associated with a user's account. It provides a transparent view of money moving in and out of the account over a selected period of time, giving users complete visibility into their account activity.
+
+To retrieve the account statement, use the [`GET /user/statement`](/api-reference/user-movements/get-account-statement) endpoint.
+
+<Tabs>
+  <Tab title="Sandbox">
+```bash
+curl --request GET \
+  --url "https://core.sandbox.gnosispay.in/user-api/user/statement?limit=&cursor=&startDate=&endDate="
+```
+  </Tab>
+  <Tab title="Production">
+```bash
+curl --request GET \
+  --url "https://core.prod.gnosispay.com/user-api/user/statement?limit=&cursor=&startDate=&endDate="
+```
+  </Tab>
+</Tabs>
+
+### Query Parameters
+
+<ParamField query="limit" type="integer">
+  Maximum number of statement entries to return per page.
+</ParamField>
+
+<ParamField query="cursor" type="string">
+  Pagination cursor for retrieving the next page of results.
+</ParamField>
+
+<ParamField query="startDate" type="string">
+  ISO-8601 date to filter statement entries from (inclusive).
+</ParamField>
+
+<ParamField query="endDate" type="string">
+  ISO-8601 date to filter statement entries up to (inclusive).
+</ParamField>
+
+## Types of Account Statement Entries
+
+Each entry in an account statement falls into one of three transaction types, each with its own set of possible statuses:
+
+| Transaction Type | Possible Statuses |
+|------------------|-------------------|
+| **Card Transactions** | `pending`, `settled`, `cancelled`, `declined` |
+| **Deposits** | `pending`, `approved`, `rejected` |
+| **Withdrawals** | `pending`, `processing`, `completed`, `failed` |
+
+<Note>
+  A declined card transaction still appears on the statement with status `declined` — see [Card Decline Reasons](/concepts/card/decline-codes) for why a transaction may be declined.
+</Note>
diff --git a/guides/accounts/limits.mdx b/guides/accounts/limits.mdx
new file mode 100644
index 0000000..2db7998
--- /dev/null
+++ b/guides/accounts/limits.mdx
@@ -0,0 +1,75 @@
+---
+title: "Account Daily Spending Limit"
+description: "Get and set the daily spending limit for the authenticated user's account"
+---
+
+<Info>
+  See [Account Overview](/concepts/accounts/account#account-spending-limits) for how user-configured and partner-configured limits interact conceptually.
+</Info>
+
+
+By default, an account's daily spending limit is `$10,000`. Users can lower this limit for their own account, but it cannot be set above $10,000 unless agreed with the partner during onboarding.
+
+<Warning>
+  This is a **cumulative daily spending limit shared across all cards on the account**, not a per-card cap. If an account has multiple cards, the combined spend across all of them together is capped at the configured limit. It is also not a per-transaction cap: an authorization that meets or exceeds the remaining limit can still be approved, after which subsequent eligible authorizations for the rest of the day are declined.
+</Warning>
+
+
+## Get Account Daily Spending Limit
+
+Returns the daily spending limit configured on the authenticated user's account.
+
+`amount` is expressed in the currency's smallest unit — for USD this means cents (e.g. `1000` = $10.00, `1000000` = $10,000.00). `syncStatus` indicates whether the most recently requested update has been fully applied.
+
+<Tabs>
+  <Tab title="Sandbox">
+```bash
+curl --request GET \
+  --url https://core.sandbox.gnosispay.in/user-api/user/account/limit \
+  --header 'Authorization: Bearer <token>'
+```
+  </Tab>
+  <Tab title="Production">
+```bash
+curl --request GET \
+  --url https://core.prod.gnosispay.com/user-api/user/account/limit \
+  --header 'Authorization: Bearer <token>'
+```
+  </Tab>
+</Tabs>
+
+
+## Set Account Daily Spending Limit
+
+Sets the daily spending limit for the authenticated user's account.
+
+`amount` is in the currency's smallest unit — for USD that means cents, so to set a $10.00 limit send `1000`, and the maximum allowed value `1000000` corresponds to $10,000.00. Must be in the range `(0, 1,000,000]`. **Only USD is currently accepted.**
+
+The response returns the new limit immediately with `syncStatus: "pending"`, transitioning to `"synced"` once the change has been applied downstream.
+
+<Tabs>
+  <Tab title="Sandbox">
+```bash
+curl --request PUT \
+  --url https://core.sandbox.gnosispay.in/user-api/user/account/limit \
+  --header 'Authorization: Bearer <token>' \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "amount": 500000,
+    "currency": "USD"
+  }'
+```
+  </Tab>
+  <Tab title="Production">
+```bash
+curl --request PUT \
+  --url https://core.prod.gnosispay.com/user-api/user/account/limit \
+  --header 'Authorization: Bearer <token>' \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "amount": 500000,
+    "currency": "USD"
+  }'
+```
+  </Tab>
+</Tabs>
diff --git a/guides/accounts/manage-accounts.mdx b/guides/accounts/manage-accounts.mdx
new file mode 100644
index 0000000..5a59f58
--- /dev/null
+++ b/guides/accounts/manage-accounts.mdx
@@ -0,0 +1,63 @@
+---
+title: "Manage Accounts"
+description: "Retrieve account details and balance information for the authenticated user"
+---
+
+<Note>
+  New to how accounts work on Gnosis Pay? Read [Account Overview](/concepts/accounts/account) first — it covers the concepts behind account balances, spending limits, and multi-currency support. This guide covers the API calls to retrieve that data.
+</Note>
+
+## Account details for authenticated user
+
+To get authenticated user account details, call [`GET /user/account`](/api-reference/user-account/get-account).
+
+<Tabs>
+  <Tab title="Sandbox">
+```bash
+curl --request GET \
+  --url https://core.sandbox.gnosispay.in/user-api/user/account
+```
+  </Tab>
+  <Tab title="Production">
+```bash
+curl --request GET \
+  --url https://core.prod.gnosispay.com/user-api/user/account
+```
+  </Tab>
+</Tabs>
+
+This will return configuration of the user's account, including chain name, configured currencies, Safe owner address, etc.
+
+## Account balances for authenticated user
+
+Account balances endpoint provides detailed balance breakdowns to give users complete visibility into their fund status. The authenticated user's account displays four distinct balance types:
+
+| Balance Type | Description | Increases When | Decreases When |
+|--------------|-------------|----------------|----------------|
+| **Spendable** | Amount available for immediate spending via card transactions or withdrawals | • Deposits clear AML analysis<br/>• Refunds are processed<br/>• Returns of goods are credited | • Card transactions are authorized<br/>• Withdrawals are initiated |
+| **Non-Spendable** | Funds that cannot be used for spending. Flagged for review or potential return | • Dependent on AML checks | • Funds are returned to source<br/>• Funds are manually released after review |
+| **Processing Deposits** | Incoming deposits currently undergoing AML analysis. Not yet available for spending | • New deposit is received | • AML analysis completes (moves to spendable or non-spendable) |
+| **Processing Withdrawals** | Outgoing withdrawals currently being processed. Deducted from spendable but not yet settled on-chain | • Withdrawal is initiated | • Withdrawal settles on-chain |
+
+### Get Account Balances
+
+To request the account balance of the user, call [`GET /user/balances/v2`](/api-reference/user-movements/get-account-balances-v2).
+
+<Tabs>
+  <Tab title="Sandbox">
+```bash
+curl --request GET \
+  --url https://core.sandbox.gnosispay.in/user-api/user/balances/v2
+```
+  </Tab>
+  <Tab title="Production">
+```bash
+curl --request GET \
+  --url https://core.prod.gnosispay.com/user-api/user/balances/v2
+```
+  </Tab>
+</Tabs>
+
+<Note>
+  Each currency maintains its own separate balance states. For example, USDC and USDT will each have their own spendable, non-spendable, processing deposits, and processing withdrawals amounts.
+</Note>
diff --git a/guides/accounts/onchain-withdrawal.mdx b/guides/accounts/onchain-withdrawal.mdx
new file mode 100644
index 0000000..88325a3
--- /dev/null
+++ b/guides/accounts/onchain-withdrawal.mdx
@@ -0,0 +1,60 @@
+---
+title: "Onchain Instant Withdrawals"
+description: "Create request to withdraw funds onchain to wallet address"
+---
+
+## Create Withdrawal Request
+
+The [`POST /user/withdrawals`](/api-reference/user-movements/create-withdrawal) endpoint allows you to create a withdrawal request for a user.
+
+The withdrawal happens to the GP Safe's owner wallet address.
+
+<Info>
+  **Withdrawals are per token.** Each withdrawal request targets a single token via `tokenAddress`.
+</Info>
+
+<Warning>
+  **Withdrawal Restrictions:**
+  - Only specific tokens are currently supported for withdrawals.
+  - Withdrawals are restricted to the Safe owner address, the wallet address that initiated the Safe deployment via the [`POST /user/account`](/api-reference/user-account/create-account) endpoint.
+</Warning>
+
+<Note>
+  **Token addresses supported for withdrawals:**
+
+  **Celo**
+  - CeloUSDT = `0x48065fbbe25f71c9282ddf5e1cd6d6a887483d5e`
+  - CeloUSDC = `0xceba9300f2b948710d2653dd7b07f33a8b32118c`
+
+  **Gnosis Chain**
+  - EURe = `0xcB444e90D8198415266c6a2724b7900fb12FC56E`
+  - GBPe = `0x5Cb9073902F2035222B9749F8fB0c9BFe5527108`
+  - USDCe = `0x2a22f9c3b484c3629090FeED35F17Ff8F88f76F0`
+
+  See [Tokens and Chains Supported](/concepts/safe/tokens-and-chains-supported) for the full reference.
+</Note>
+
+<Tabs>
+  <Tab title="Sandbox">
+```bash
+curl --request POST \
+  --url https://core.sandbox.gnosispay.in/user-api/user/withdrawals \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "tokenAddress": "<string>",
+    "amount": "<string>"
+  }'
+```
+  </Tab>
+  <Tab title="Production">
+```bash
+curl --request POST \
+  --url https://core.prod.gnosispay.com/user-api/user/withdrawals \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "tokenAddress": "<string>",
+    "amount": "<string>"
+  }'
+```
+  </Tab>
+</Tabs>
diff --git a/guides/auth-with-siwe.mdx b/guides/auth-with-siwe.mdx
new file mode 100644
index 0000000..bdee717
--- /dev/null
+++ b/guides/auth-with-siwe.mdx
@@ -0,0 +1,156 @@
+---
+title: "Authenticating with SIWE"
+description: "Implement the SIWE-based authentication flow: retrieving, using, and rotating access and refresh tokens"
+---
+
+<Note>
+  To know how authentication and token rotation works in Gnosis Pay, read [Authentication & Tokens guide](/concepts/auth/token). This guide covers the implementation steps.
+</Note>
+
+## Authentication Flow
+
+Let's take a look at how to complete SIWE validation and retrieve access tokens.
+
+<Steps>
+  <Step title="Get SIWE Message to sign">
+    Request the message that users need to Sign in with Ethereum (SIWE) by calling the endpoint with the wallet address in the path and required query parameters.
+
+    <Note>
+      **Domain Whitelisting Required**: We validate domains on our end for security. Your SIWE message must originate from a domain that has been pre-approved and whitelisted in our system. Contact our team to whitelist your domain before implementing authentication.
+    </Note>
+
+    See full specification: [GET /auth/siwe/{address}](/api-reference/auth/get-siwe-message)
+
+    <Tabs>
+      <Tab title="Sandbox">
+```bash
+# these values require prior partner registration (self signup)
+export APP_DOMAIN="myapp.xyz"
+export APP_URI="https://myapp.xyz"
+export APP_NAME="MyCardApp"
+
+curl --request GET \
+  --url https://core.sandbox.gnosispay.in/user-api/auth/siwe/{address}?domain=$APP_DOMAIN&uri=$APP_URI&appName=$APP_NAME
+```
+      </Tab>
+      <Tab title="Production">
+```bash
+# these values require prior partner registration (provisioned by Gnosis team)
+export APP_DOMAIN="myapp.xyz"
+export APP_URI="https://myapp.xyz"
+export APP_NAME="MyCardApp"
+
+curl --request GET \
+  --url https://core.prod.gnosispay.com/user-api/auth/siwe/{address}?domain=$APP_DOMAIN&uri=$APP_URI&appName=$APP_NAME
+```
+      </Tab>
+    </Tabs>
+  </Step>
+
+  <Step title="Get Access and Refresh Token">
+    Submit the signed SIWE message to verify authentication and receive your token pair. Send the wallet address, signature from the user's wallet, and the original SIWE message to get both access and refresh tokens.
+
+    See full specification: [POST /auth/siwe](/api-reference/auth/get-access-token)
+
+    <Tabs>
+      <Tab title="Sandbox">
+```bash
+curl --request POST \
+  --url https://core.sandbox.gnosispay.in/user-api/auth/siwe \
+  --header 'Content-Type: application/json' \
+  --data '{
+      "address": "<string>",
+      "signature": "<string>",
+      "message": "<string>"
+  }'
+```
+      </Tab>
+      <Tab title="Production">
+```bash
+curl --request POST \
+  --url https://core.prod.gnosispay.com/user-api/auth/siwe \
+  --header 'Content-Type: application/json' \
+  --data '{
+      "address": "<string>",
+      "signature": "<string>",
+      "message": "<string>"
+  }'
+```
+      </Tab>
+    </Tabs>
+
+    <Warning>
+      **Secure Storage Required**: Store the refresh token securely to prevent XSS attacks. While our system has mechanisms to invalidate sessions if tokens are compromised, developers must implement proper security measures and secure storage APIs to protect against client-side vulnerabilities.
+    </Warning>
+  </Step>
+
+  <Step title="Refresh Access Token">
+    Exchange a valid refresh token for a new access token and rotated refresh token. This should be called automatically when your access token expires (every 15 minutes) or when you receive a 401 response.
+
+    See full specification: [POST /auth/refresh](/api-reference/auth/refresh-access-token)
+
+    <Tabs>
+      <Tab title="Sandbox">
+```bash
+curl --request POST \
+  --url https://core.sandbox.gnosispay.in/user-api/auth/refresh \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "refreshToken": "your_refresh_token_here"
+  }'
+```
+      </Tab>
+      <Tab title="Production">
+```bash
+curl --request POST \
+  --url https://core.prod.gnosispay.com/user-api/auth/refresh \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "refreshToken": "your_refresh_token_here"
+  }'
+```
+      </Tab>
+    </Tabs>
+
+    <Info>
+      **Token Rotation**: Each refresh request invalidates the previous refresh token and issues a new one. Always store the new refresh token from the response for subsequent refresh requests.
+    </Info>
+
+    <Warning>
+      The refresh token should only be used once. If a refresh token is used twice, the user will be automatically logged out. Preventing race conditions is essential to maintain session integrity.
+    </Warning>
+  </Step>
+</Steps>
+
+### Revoking access tokens
+
+To securely log out a user, revoke their current session by invalidating all refresh tokens in the token family.
+
+<Warning>
+  After successful logout, remove the refresh token from your client's secure storage to complete the logout process.
+</Warning>
+
+See full specification: [POST /auth/logout](/api-reference/auth/logout)
+
+<Tabs>
+  <Tab title="Sandbox">
+```bash
+curl --request POST \
+  --url https://core.sandbox.gnosispay.in/user-api/auth/logout \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "refreshToken": "your_refresh_token_here"
+  }'
+```
+  </Tab>
+  <Tab title="Production">
+```bash
+curl --request POST \
+  --url https://core.prod.gnosispay.com/user-api/auth/logout \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "refreshToken": "your_refresh_token_here"
+  }'
+```
+  </Tab>
+</Tabs>
diff --git a/guides/cards/card-limit.mdx b/guides/cards/card-limit.mdx
new file mode 100644
index 0000000..6ce45db
--- /dev/null
+++ b/guides/cards/card-limit.mdx
@@ -0,0 +1,70 @@
+---
+title: "Card Daily Spending Limit"
+description: "Get and set the daily spending limit for a specific card"
+---
+
+
+<Note>
+  **Why this matters for users:** a user with multiple cards may want to limit how much a specific card can spend. For example, capping a card shared with a family member, or a card used only for subscriptions, without changing the overall account limit that governs their other cards. This gives users finer-grained control over their own spending habits.
+</Note>
+
+<Info>
+  A card's limit only takes effect if it's set **lower** than the [account's daily spending limit](guides/accounts/limits), the account limit is always the hard ceiling, regardless of any card-level limit.
+</Info>
+
+## Set Card Daily Spending Limit
+
+Sets the daily spending limit for a card.
+
+`amount` is expressed in the currency's smallest unit, for USD this means cents (e.g. `1000` = `$10.00`, `1000000` = `$10,000.00`). The card must belong to the authenticated user.
+
+The response returns the new limit immediately with `syncStatus: "pending"`, transitioning to `"synced"` once the change has been applied downstream.
+
+<Tabs>
+  <Tab title="Sandbox">
+```bash
+curl --request PUT \
+  --url https://core.sandbox.gnosispay.in/user-api/cards/{cardId}/limit \
+  --header 'Authorization: Bearer <token>' \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "amount": 500000,
+    "currency": "USD"
+  }'
+```
+  </Tab>
+  <Tab title="Production">
+```bash
+curl --request PUT \
+  --url https://core.prod.gnosispay.com/user-api/cards/{cardId}/limit \
+  --header 'Authorization: Bearer <token>' \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "amount": 500000,
+    "currency": "USD"
+  }'
+```
+  </Tab>
+</Tabs>
+
+
+## Get Card Daily Spending Limit
+
+Returns the daily spending limit configured on a card.
+
+<Tabs>
+  <Tab title="Sandbox">
+```bash
+curl --request GET \
+  --url https://core.sandbox.gnosispay.in/user-api/cards/{cardId}/limit \
+  --header 'Authorization: Bearer <token>'
+```
+  </Tab>
+  <Tab title="Production">
+```bash
+curl --request GET \
+  --url https://core.prod.gnosispay.com/user-api/cards/{cardId}/limit \
+  --header 'Authorization: Bearer <token>'
+```
+  </Tab>
+</Tabs>
diff --git a/guides/cards/card-simulator.mdx b/guides/cards/card-simulator.mdx
new file mode 100644
index 0000000..b4039e6
--- /dev/null
+++ b/guides/cards/card-simulator.mdx
@@ -0,0 +1,310 @@
+---
+title: "Simulate Card Transactions"
+description: "Simulate card transactions for testing purposes as part of the sandbox environment"
+---
+
+<Note>
+  New to the sandbox environment? Read [Sandbox vs Production](/guides/configuring-environment) to understand more about sandbox environment.
+</Note>
+
+## Card Transaction Simulator
+
+The Card Transaction Simulator allows you to test full card transaction lifecycles in the sandbox environment, without sending transactions to the live card network.
+
+When you send a transaction request:
+
+1. The simulator authenticates the request
+2. It checks available balance
+3. It applies lifecycle logic:
+   - **Authorization** creates a hold
+   - **Reversal** releases a hold
+   - **Replacement** adjusts an existing hold
+   - **Clearing** confirms/settles a transaction
+   - **Clearing Cancellation** cancels via clearing
+4. It returns an approval or denial response with production-like fields
+
+```
+https://core.sandbox.gnosispay.in/docs/simulator-api
+```
+
+
+## How to Simulate a Card Transaction
+
+<Steps>
+  <Step title="Authenticate with the Simulator API">
+    Use HTTP Basic Auth:
+    - **Username:** `simulator`
+    - **Password:** Provided during onboarding
+
+    All simulator endpoints require authentication.
+  </Step>
+
+  <Step title="Choose the Card Identifier">
+    You can simulate transactions using:
+    - `card_id` → `POST /transactions/simulate`
+    - `pan` → `POST /transactions/simulate-by-pan`
+
+    Both endpoints behave identically.
+  </Step>
+
+  <Step title="Understand Request Fields">
+    All simulation requests use these fields:
+
+    | Field | Type | Required | Description |
+    |---|---|---|---|
+    | `transaction_type` | string | Yes | `authorization`, `reversal`, `replacement`, `clearing`, or `clearing_cancellation` |
+    | `card_id` | uuid | Yes* | Card UUID (use `pan` instead on the by-PAN endpoint) |
+    | `pan` | string | Yes* | Card PAN (only on the by-PAN endpoint) |
+    | `amount` | string | Yes | Amount in major units (e.g., `"100.50"`) |
+    | `currency` | string | Yes | `USD`, `EUR`, or `GBP` |
+    | `authorization_code` | string | Conditional | Required for `reversal`, `replacement`, `clearing`, and `clearing_cancellation` |
+    | `replacement_amount` | string | Conditional | Required for `replacement` |
+    | `merchant_name` | string | No | Defaults to `"TEST MERCHANT"` |
+    | `merchant_code` | string | No | MCC code. Defaults to `"5541"` |
+  </Step>
+</Steps>
+
+## Transaction Types
+
+The simulator supports five transaction types that form a complete lifecycle: **authorization**, **reversal**, **replacement**, **clearing**, and **clearing cancellation**.
+
+### Simulate an Authorization
+
+Authorization creates an initial hold on the card balance.
+
+<Steps>
+  <Step title="Send Authorization Request">
+```json
+{
+  "transaction_type": "authorization",
+  "card_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+  "amount": "100.50",
+  "currency": "USD"
+}
+```
+
+    **Required:** `transaction_type`, `amount`, `currency`, and `card_id` or `pan`.
+  </Step>
+
+  <Step title="Simulator Validation">
+    The simulator will:
+    - Confirm the card exists
+    - Verify the card is active
+    - Check sufficient available balance
+    - Place a hold for the requested amount
+  </Step>
+
+  <Step title="Store Authorization Code">
+    If approved, the response includes `authorization_code` and `authorization_id`.
+
+    <Warning>
+      **Save the `authorization_code`** as it's required for reversals, replacements, and clearing operations.
+    </Warning>
+  </Step>
+</Steps>
+
+### Simulate a Reversal
+
+Reversal cancels a previous authorization entirely and releases the held amount.
+
+<Steps>
+  <Step title="Provide Authorization Code">
+    You must use the `authorization_code` returned from the original authorization.
+  </Step>
+
+  <Step title="Send Reversal Request">
+```json
+{
+  "transaction_type": "reversal",
+  "card_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+  "amount": "100.50",
+  "currency": "USD",
+  "authorization_code": "ABC123"
+}
+```
+  </Step>
+
+  <Step title="Simulator Behavior">
+    The simulator will:
+    - Validate the original authorization exists
+    - Confirm the amount matches
+    - Release the full held balance
+  </Step>
+</Steps>
+
+### Simulate a Replacement
+
+Replacement adjusts a previous authorization to a different amount.
+
+<Steps>
+  <Step title="Provide Authorization Code">
+    Use the `authorization_code` from the original authorization.
+  </Step>
+
+  <Step title="Send Replacement Request">
+```json
+{
+  "transaction_type": "replacement",
+  "card_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+  "amount": "100.50",
+  "currency": "USD",
+  "authorization_code": "ABC123",
+  "replacement_amount": "75.00"
+}
+```
+
+    **Required:** `authorization_code` and `replacement_amount`.
+  </Step>
+
+  <Step title="Simulator Behavior">
+    The simulator will:
+    - Validate the original authorization
+    - Reduce or increase the held amount
+    - Update the balance accordingly
+  </Step>
+</Steps>
+
+### Simulate a Clearing
+
+Clearing confirms a previous authorization (settlement/Base II) and finalizes the transaction.
+
+<Steps>
+  <Step title="Provide Authorization Code">
+    Use the `authorization_code` from the original authorization.
+  </Step>
+
+  <Step title="Send Clearing Request">
+```json
+{
+  "transaction_type": "clearing",
+  "card_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+  "amount": "100.50",
+  "currency": "USD",
+  "authorization_code": "ABC123"
+}
+```
+  </Step>
+
+  <Step title="Simulator Behavior">
+    The simulator will:
+    - Validate the original authorization
+    - Process the settlement
+    - Finalize the transaction
+
+    <Warning>
+      The simulator requires a minimum 2-minute gap between clearing messages for the same authorization. Sending a second clearing before this window elapses will result in a `409` error.
+    </Warning>
+  </Step>
+</Steps>
+
+### Simulate a Clearing Cancellation
+
+Clearing cancellation cancels a transaction via clearing. For partial cancellation, send an amount lower than the original authorization.
+
+<Steps>
+  <Step title="Provide Authorization Code">
+    Use the `authorization_code` from the original authorization.
+  </Step>
+
+  <Step title="Send Clearing Cancellation Request">
+```json
+{
+  "transaction_type": "clearing_cancellation",
+  "card_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+  "amount": "100.50",
+  "currency": "USD",
+  "authorization_code": "ABC123"
+}
+```
+  </Step>
+
+  <Step title="Simulator Behavior">
+    The simulator will:
+    - Validate the original authorization
+    - Process the cancellation
+    - Adjust balances accordingly
+
+    <Note>
+      For partial cancellations, use an amount lower than the original authorization amount.
+    </Note>
+  </Step>
+</Steps>
+
+## Response Handling
+
+### Approved (Authorization)
+
+An approved authorization response includes full transaction details:
+
+```json
+{
+  "status": "approved",
+  "authorization_code": "ABC123",
+  "authorization_id": 98765432,
+  "authorization_date_time": "2025-06-15T14:30:00Z",
+  "settlement_amount": "100.50",
+  "mode_type": "DEBIT",
+  "card_mode": "CHIP",
+  "is_domestic_transaction": true
+}
+```
+
+### Approved (Clearing / Clearing Cancellation)
+
+Clearing responses are sparse as most fields will be empty or zero-valued:
+
+```json
+{
+  "status": "approved",
+  "authorization_code": "",
+  "authorization_id": 0,
+  "authorization_date_time": "0001-01-01T00:00:00Z",
+  "settlement_amount": "",
+  "mode_type": "",
+  "card_mode": "",
+  "is_domestic_transaction": false
+}
+```
+
+### Denied
+
+If denied, the response includes detailed denial information:
+
+```json
+{
+  "status": "denied",
+  "authorization_code": "",
+  "authorization_id": 98765432,
+  "authorization_date_time": "2025-06-15T14:30:00Z",
+  "settlement_amount": "0.00",
+  "mode_type": "DEBIT",
+  "card_mode": "CHIP",
+  "is_domestic_transaction": true,
+  "denial_code": "810",
+  "denial_reason": "Insufficient balance"
+}
+```
+
+<Note>
+  `denial_code` and `denial_reason` use the same codes documented in [Card Decline Reasons](/concepts/card/decline-codes), use the simulator to test the responses and showcase the right mapping according to the guide.
+</Note>
+
+## Error Handling
+
+Validation and authentication errors return structured error objects:
+
+```json
+{
+  "code": 400,
+  "message": "authorization_code is required for reversal, replacement, and clearing transactions"
+}
+```
+
+**Possible HTTP status codes:**
+
+| Status | Cause |
+|--------|-------|
+| `401` | Invalid credentials |
+| `400` | Validation error (missing fields, invalid amount/currency) |
+| `404` | Card or account not found |
+| `409` | Clearing collision — a clearing message is already being processed for this authorization. Wait at least 2 minutes between clearing messages |
diff --git a/guides/cards/create-virtual.mdx b/guides/cards/create-virtual.mdx
new file mode 100644
index 0000000..38337b9
--- /dev/null
+++ b/guides/cards/create-virtual.mdx
@@ -0,0 +1,168 @@
+---
+title: "Create Virtual Card"
+description: "Create and manage virtual cards for users"
+---
+
+Virtual cards are activated immediately after creation and can be used for online purchases right away.
+
+## Card Activation
+
+To create a card for a user, call [`POST /cards/virtual`](/api-reference/cards/create-virtual-card) with a `cardName`. Once successful, you will get a `cardId`.
+
+The card's `status` will first be `provisioning` until our card provider has fully created the card. This is an asynchronous task. We recommend showing this `status` to your users, and polling the `/cards` endpoint regularly until it becomes `active`. The provisioning process should not last more than 10 seconds.
+
+The request accepts an optional `phone` field (E.164 format). The behavior depends on whether the user already has a `cardholderId`:
+
+| Scenario | Result |
+|----------|--------|
+| User already has a `cardholderId` | Card created directly; `phone` is ignored |
+| No `cardholderId`, no `phone` provided | `422 PHONE_REQUIRED` |
+| No `cardholderId`, valid `phone` provided | Cardholder created via API, then card created |
+
+<Tabs>
+  <Tab title="Sandbox">
+```bash
+curl --request POST \
+  --url https://core.sandbox.gnosispay.in/user-api/cards/virtual \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "cardName": "<string>",
+    "phone": "<string>"
+  }'
+```
+  </Tab>
+  <Tab title="Production">
+```bash
+curl --request POST \
+  --url https://core.prod.gnosispay.com/user-api/cards/virtual \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "cardName": "<string>",
+    "phone": "<string>"
+  }'
+```
+  </Tab>
+</Tabs>
+
+
+## Card transactions and enrichment
+
+A user's card transactions are returned as `card_transaction` entries via [`GET /user/statement`](/api-reference/user-movements/get-account-statement). Each entry includes both the raw transaction data from the card network and an `enrichment` object with matched merchant, category, and location data which lets developers build a clean, recognizable transaction feed instead of showing raw network descriptors.
+
+<Info>
+  See [Transaction Enrichment](/concepts/card/transaction-enrichment) for why this matters and how matching works conceptually.
+</Info>
+
+```json
+{
+  "data": [
+    {
+      "type": "card_transaction",
+      "id": "<string>",
+      "status": "pending",
+      "amount": "<string>",
+      "currency": "<string>",
+      "decimals": 123,
+      "originalAmount": "<string>",
+      "originalCurrency": "<string>",
+      "originalDecimals": 123,
+      "isCredit": true,
+      "createdAt": "2023-11-07T05:31:56Z",
+      "updatedAt": "2023-11-07T05:31:56Z",
+      "description": "<string>",
+      "authorizationId": 123,
+      "mcc": "<string>",
+      "authorizationCode": "<string>",
+      "merchant": {
+        "name": "<string>",
+        "city": "<string>",
+        "country": "<string>",
+        "categoryCode": "<string>"
+      },
+      "entryMode": "<string>",
+      "billing": {
+        "billingAmount": "<string>",
+        "billingCurrency": {
+          "symbol": "<string>",
+          "code": "<string>",
+          "decimals": 123,
+          "name": "<string>"
+        }
+      },
+      "transactionCurrency": {
+        "symbol": "<string>",
+        "code": "<string>",
+        "decimals": 123,
+        "name": "<string>"
+      },
+      "cardId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
+      "cardToken": "<string>",
+      "clearedAt": "2023-11-07T05:31:56Z",
+      "isPending": true,
+      "kind": "Payment",
+      "transactions": [
+        {
+          "status": "<string>",
+          "to": "<string>",
+          "value": "<string>",
+          "data": "<string>",
+          "hash": "<string>"
+        }
+      ],
+      "declineReason": {
+        "code": "<string>",
+        "message": "<string>"
+      },
+      "wallet": {
+        "provider": "apple_pay",
+        "deviceBrand": "<string>",
+        "deviceModel": "<string>",
+        "deviceType": "<string>",
+        "deviceName": "<string>"
+      },
+      "enrichment": {
+        "status": "matched",
+        "merchant": {
+          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
+          "name": "<string>",
+          "logoUrl": "<string>"
+        },
+        "shop": {
+          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
+          "type": "<string>",
+          "category": {
+            "name": "<string>",
+            "logoUrl": "<string>"
+          },
+          "tags": ["<string>"],
+          "address": {
+            "street": "<string>",
+            "city": "<string>",
+            "zip": "<string>",
+            "country": "<string>",
+            "areas": [
+              {
+                "name": "<string>",
+                "value": "<string>"
+              }
+            ]
+          },
+          "coordinates": {
+            "latitude": 123,
+            "longitude": 123,
+            "accuracy": "<string>",
+            "zoom": 123
+          },
+          "url": "<string>",
+          "googlePlaceId": "<string>",
+          "phoneNumber": "<string>"
+        }
+      }
+    }
+  ],
+  "pagination": {
+    "nextCursor": "<string>",
+    "hasNext": true
+  }
+}
+```
diff --git a/guides/configuring-environment.mdx b/guides/configuring-environment.mdx
new file mode 100644
index 0000000..38a256b
--- /dev/null
+++ b/guides/configuring-environment.mdx
@@ -0,0 +1,56 @@
+---
+title: "Sandbox vs Production"
+description: "Understanding the difference between the sandbox and production environments"
+---
+
+Gnosis Pay provides two separate environments for integrating with our API: **sandbox** and **production**. This page explains what each is for, who can access them, and what's available in sandbox to help you build and test your integration before going live.
+
+## Sandbox
+
+The sandbox environment is **open to all developer teams and product**, whether it is for exploring Gnosis Pay stack for the first time, building a proof of concept, or running a phased testing process ahead of a production launch.
+
+<Info>
+  All the base URLs used throughout these docs (`core.sandbox.gnosispay.in`) point to the sandbox environment, so developers start integrating testing features immediately. Partners still need to whitelist domains with us for SIWE flows.
+</Info>
+
+### Sandbox features
+
+**1. KYC testing via Sumsub sandbox**
+
+The KYC flow runs against Sumsub's sandbox environment, so developers can test the full identity verification experience using Sumsub's own test templates, without submitting any real personal data or waiting for manual approval. This includes testing different KYC outcomes (approved, resubmission requested, manual review, rejected) to make sure integration handles each status correctly. Read the **sandbox environment** guide for [testing Sumsub flow](/guides/onboarding#3-kyc-process).
+
+**2. Transaction simulator**
+
+Simulate card transactions to see how they perform in real-time across different states such as authorizations, declines, refunds, and reversals without needing a live card network connection. This lets you build and test transaction handling, webhooks, and UI states end-to-end before any real money or card is involved.
+
+
+
+<Note>
+  See [KYC Statuses](/concepts/kyc/kyc-statuses) for the full list of statuses your integration should handle.
+</Note>
+
+## Production Environment
+
+Production access is only granted when there is a partnership agreement between a partner with Gnosis Pay. As part of onboarding, Gnosis Pay team will provide you the following:
+
+- Provision **partner** access for [Partner Dashboard access](https://partners.gnosispay.com) and production APIs
+- **Whitelist product domain(s)** to allow SIWE authentication requests to be issued and verified against the application
+- Enable domain to **host secure card elements** for displaying sensitive card data (such as card numbers or CVVs) directly in application
+
+<Warning>
+  Production credentials are not self-serve. If you're ready to move from sandbox testing to production, [contact sales] to begin the partnership process.
+</Warning>
+
+## Choosing an environment
+
+| | Sandbox | Production |
+|---|---|---|
+| **Who can access it** | Anyone | Post partnership agreement|
+| **Requires an agreement** | No | Yes |
+| **Card activity** | Simulated on test network | Transaction happens in real-time on card network |
+| **KYC provider** | Sumsub sandbox (test documents) | Sumsub production (real documents) |
+| **Domain whitelisting required** | Yes | Yes |
+
+<Note>
+  Every endpoint in these docs includes both **Sandbox** and **Production** request examples, switch between them using the tabs on each code block.
+</Note>
diff --git a/guides/kyc-sharing/monerium.mdx b/guides/kyc-sharing/monerium.mdx
new file mode 100644
index 0000000..6be9e27
--- /dev/null
+++ b/guides/kyc-sharing/monerium.mdx
@@ -0,0 +1,137 @@
+---
+title: "Monerium IBAN Integration"
+description: "Share a user's verified KYC data with Monerium to enable IBAN issuance"
+---
+
+<Note>
+  Before starting, read [KYC Sharing (Sumsub Flow)](/guides/kyc-sharing/pass-kyc) as this guide builds directly on the share-token flow described there.
+</Note>
+
+Gnosis Pay integrates with **Monerium** to offer users an IBAN linked to their account. Rather than requiring the user to complete KYC a second time with Monerium, their already-verified Sumsub identity data can be shared directly with Monerium, which reuses it to populate and verify the user's Monerium profile.
+
+Monerium is configured as a Sumsub **recipient** on our end, meaning your integration flow requests a Sumsub share token scoped specifically for Monerium's client ID, then forwards that token to Monerium.
+
+## How it works
+
+<Steps>
+  <Step title="Request a Sumsub share token for Monerium">
+    Call [`POST /kyc/import-partner-applicant`](/api-reference/kyc/generate-kyc-applicant-share-token) with `forClientId` set to Monerium's Sumsub client ID.
+
+    <Tabs>
+      <Tab title="Sandbox">
+```bash
+        curl --request POST \
+          --url https://core.sandbox.gnosispay.in/user-api/kyc/import-partner-applicant \
+          --header 'Authorization: Bearer <token>' \
+          --header 'Content-Type: application/json' \
+          --data '{
+            "forClientId": "<monerium_sumsub_client_id>",
+            "ttlInSecs": 1200
+          }'
+```
+      </Tab>
+      <Tab title="Production">
+```bash
+        curl --request POST \
+          --url https://core.prod.gnosispay.com/user-api/kyc/import-partner-applicant \
+          --header 'Authorization: Bearer <token>' \
+          --header 'Content-Type: application/json' \
+          --data '{
+            "forClientId": "<monerium_sumsub_client_id>",
+            "ttlInSecs": 1200
+          }'
+```
+      </Tab>
+    </Tabs>
+
+    The response returns a single-use `token`:
+
+```json
+    {
+      "token": "<string>",
+      "forClientId": "<monerium_sumsub_client_id>"
+    }
+```
+
+    <Warning>
+      This token is single-use and expires after `ttlInSecs` (default 1200 seconds). Request a fresh token immediately before passing it to Monerium, don't generate it ahead of time and store it.
+    </Warning>
+  </Step>
+
+  <Step title="Share the token with Monerium">
+
+     <Info>
+      This call is made directly to Monerium's API using your own Monerium partner credentials (`BearerAuth`) not a Gnosis Pay endpoint. Note Monerium's sandbox uses `.dev` (fake money) and production uses `.app` (real money),this differs from Gnosis Pay's own `.sandbox` / `.prod` domain pattern, so don't mix them up.
+    </Info>
+
+    Pass the `token` from Step 1 to [Monerium's Share KYC Data endpoint](https://docs.monerium.com/api/#tag/profiles/operation/share-profile-kyc), under the `personal` object, with `provider` set to `"sumsub"`.
+
+    <Tabs>
+      <Tab title="Sandbox">
+```bash
+        curl --request POST \
+          --url "https://api.monerium.dev/profiles/{profile}/share" \
+          --header 'Authorization: Bearer <monerium_bearer_token>' \
+          --header 'Accept: application/vnd.monerium.api-v2+json' \
+          --header 'Content-Type: application/json' \
+          --data '{
+            "provider": "sumsub",
+            "personal": {
+              "token": "<sumsub_share_token>"
+            }
+          }'
+```
+      </Tab>
+      <Tab title="Production">
+```bash
+        curl --request POST \
+          --url "https://api.monerium.app/profiles/{profile}/share" \
+          --header 'Authorization: Bearer <monerium_bearer_token>' \
+          --header 'Accept: application/vnd.monerium.api-v2+json' \
+          --header 'Content-Type: application/json' \
+          --data '{
+            "provider": "sumsub",
+            "personal": {
+              "token": "<sumsub_share_token>"
+            }
+          }'
+```
+      </Tab>
+    </Tabs>
+
+    Monerium uses the supplied token to fetch the user's data directly from Sumsub and populates the relevant sections of the user's Monerium profile. Each section that receives sufficient data transitions to `pending`; any section that remains incomplete stays `incomplete`.
+
+
+  </Step>
+
+  <Step title="Data reaches Monerium">
+    Once Monerium has ingested the shared KYC data, the relevant sections of the user's profile move to `pending` review on Monerium's side. No further action is needed from your integration until Monerium's review completes.
+  </Step>
+
+  <Step title="Request IBAN issuance">
+    Once the profile's KYC sections are approved by Monerium, you can request IBAN issuance directly through Monerium's own API.
+
+    <Note>
+      See Monerium's own API reference for the IBAN issuance endpoint, this is a separate call from KYC sharing above.
+    </Note>
+  </Step>
+</Steps>
+
+## Summary
+
+```mermaid
+sequenceDiagram
+    participant User
+    participant GnosisPay
+    participant Sumsub
+    participant Monerium
+
+    User->>GnosisPay: Authenticated request
+    GnosisPay->>Sumsub: Request share token (forClientId = Monerium)
+    Sumsub->>GnosisPay: Return single-use token
+    GnosisPay->>Monerium: POST /profiles/{profile}/share (provider: sumsub, token)
+    Monerium->>Sumsub: Fetch applicant data using token
+    Monerium->>Monerium: Populate profile, sections move to pending
+    Monerium->>GnosisPay: KYC approved
+    GnosisPay->>Monerium: Request IBAN issuance
+```
diff --git a/guides/kyc-sharing/pass-kyc.mdx b/guides/kyc-sharing/pass-kyc.mdx
new file mode 100644
index 0000000..1e15abd
--- /dev/null
+++ b/guides/kyc-sharing/pass-kyc.mdx
@@ -0,0 +1,47 @@
+---
+title: "KYC Sharing with Sumsub"
+description: "Generate a Sumsub share token to reuse a user's verified KYC identity with a partner"
+---
+
+
+<Note>
+  Read [KYC Overview](/concepts/kyc/overview) as it covers why we use Sumsub and the full KYC status lifecycle. This guide covers how to share a user's already-verified identity with a partner via Sumsub.
+</Note>
+
+If a user has already completed KYC with Gnosis Pay, that verified identity can be **reused** rather than requiring the user to go through verification again with a partner. This is done by generating a temporary **Sumsub share token**, which the partner uses on their end to import the applicant's already-verified data.
+
+## Generate KYC Applicant Share Token
+
+Generates a temporary Sumsub share token for the authenticated user's KYC applicant. Pass this token to the named Sumsub recipient (the partner) to reuse the applicant's verified identity data.
+
+<Tabs>
+  <Tab title="Sandbox">
+```bash
+    curl --request POST \
+      --url https://core.sandbox.gnosispay.in/user-api/kyc/import-partner-applicant \
+      --header 'Authorization: Bearer <token>' \
+      --header 'Content-Type: application/json' \
+      --data '{
+        "forClientId": "<string>",
+        "ttlInSecs": 1200
+      }'
+```
+  </Tab>
+  <Tab title="Production">
+```bash
+    curl --request POST \
+      --url https://core.prod.gnosispay.com/user-api/kyc/import-partner-applicant \
+      --header 'Authorization: Bearer <token>' \
+      --header 'Content-Type: application/json' \
+      --data '{
+        "forClientId": "<string>",
+        "ttlInSecs": 1200
+      }'
+```
+  </Tab>
+</Tabs>
+
+
+<Warning>
+  The share token is **single-use** and expires after `ttlInSecs` (or Sumsub's default of 1200 seconds if not specified). Generate a new token for each sharing attempt — it cannot be reused once consumed or expired.
+</Warning>
diff --git a/guides/onboarding.mdx b/guides/onboarding.mdx
new file mode 100644
index 0000000..7e4d202
--- /dev/null
+++ b/guides/onboarding.mdx
@@ -0,0 +1,433 @@
+---
+title: "Onboard to Gnosis Pay"
+description: "User onboarding using Gnosis Pay"
+---
+
+This documentation provides a step-by-step guide on how to test the user onboarding experience for Gnosis Pay for both environments.
+
+## 1. Authentication
+
+<Steps>
+  <Step title="Get access token">
+    Before proceeding, complete the SIWE authentication flow to obtain an access token. See the integration guide for [authenticating with SIWE](/guides/auth-with-siwe).
+  </Step>
+</Steps>
+
+## 2. User Registration
+
+<Steps titleSize="h3">
+  <Step title="Sign up with email">
+    Send an email verification request to [`POST /email-verification`](/api-reference/auth/request-email-verification) with a One-Time Password (OTP) to the user's email address.
+
+    <Tabs>
+      <Tab title="Sandbox">
+```bash cURL
+curl --request POST \
+  --url https://core.sandbox.gnosispay.in/user-api/email-verification \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "email": "jsmith@example.com"
+  }'
+```
+      </Tab>
+      <Tab title="Production">
+```bash cURL
+curl --request POST \
+  --url https://core.prod.gnosispay.com/user-api/email-verification \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "email": "jsmith@example.com"
+  }'
+```
+      </Tab>
+    </Tabs>
+  </Step>
+
+  <Step title="Register user">
+    Register a new user with email OTP and create a user profile. POST [`/user`](/api-reference/user/register-user) endpoint returns a new access token with userID that must be used as the bearer token for all subsequent API requests — otherwise the calls will fail.
+
+    Optionally, provide a shareToken for Sumsub reusable KYC.
+
+    <Note>
+      If the access token lacks a `userID`, it indicates that user registration failed because the email was never properly submitted.
+    </Note>
+
+    <Tabs>
+      <Tab title="Sandbox">
+```bash cURL
+curl --request POST \
+  --url https://core.sandbox.gnosispay.in/user-api/user \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "email": "jsmith@example.com",
+    "otp": "<string>",
+    "shareToken": "<string>"
+  }'
+```
+      </Tab>
+      <Tab title="Production">
+```bash cURL
+curl --request POST \
+  --url https://core.prod.gnosispay.com/user-api/user \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "email": "jsmith@example.com",
+    "otp": "<string>",
+    "shareToken": "<string>"
+  }'
+```
+      </Tab>
+    </Tabs>
+  </Step>
+
+  <Step title="Get onboarding status of user">
+    After user registration, use the access token to retrieve the user's current onboarding status. [`GET /user/onboarding`](/api-reference/user/get-onboarding-status) will indicate the next required step in the onboarding process.
+
+    #### User Onboarding States
+
+    The onboarding status values indicate the current step and required user actions:
+
+    | Status | Description | User Action Required |
+    |--------|-------------|---------------------|
+    | `action_accept_tos` | Terms of Service acceptance required - user registered but hasn't accepted required terms | Review and accept Terms of Service |
+    | `waiting_kyc_setup` | KYC initialization in progress - all terms accepted, KYC process being set up | Wait for KYC setup completion |
+    | `action_complete_kyc` | KYC verification pending - KYC check created but pending user completion | Complete KYC verification via Sumsub `webSdkUrl` |
+    | `kyc_manual_review` | KYC provider flagged the check as requiring manual review | This is a non-recoverable state from the user's side, requires internal review for updating application status |
+    | `action_kyc_resubmission_requested` | KYC provider has requested the user resubmit their KYC documents — a new Sumsub session URL is provided | Re-complete KYC verification via Sumsub using the provided `webSdkUrl` |
+    | `action_complete_sof` | Source of Funds questionnaire required - KYC approved, SOF answers needed | Answer Source of Funds questionnaire |
+    | `action_create_account` | Ready for account creation - KYC approved and SOF completed | Proceed with account creation |
+    | `waiting_account_setup` | Account provisioning in progress - account is being set up in the system | Wait for account setup completion |
+    | `action_verify_phone` | Phone verification required, account is active but user can't create card until phone is verified.| Verify phone number |
+    | `completed` | Onboarding complete - account is active with cardholder ID | Start using the platform |
+    | `rejected` | Onboarding rejected - account is blocked, closed, or KYC verification failed | Contact support or retry if applicable |
+
+    <Tabs>
+      <Tab title="Sandbox">
+```bash cURL
+curl --request GET \
+  --url https://core.sandbox.gnosispay.in/user-api/user/onboarding
+```
+      </Tab>
+      <Tab title="Production">
+```bash cURL
+curl --request GET \
+  --url https://core.prod.gnosispay.com/user-api/user/onboarding
+```
+      </Tab>
+    </Tabs>
+  </Step>
+
+  <Step title="Accept Terms of Service (ToS)">
+    At this point, the user is registered in the Gnosis Pay system and has an associated `userID`. Call the endpoint [`GET /user/onboarding`](/api-reference/user/get-onboarding-status). The response JSON will be returned with status of `action_accept_tos`.
+
+```json
+{
+  "status": "action_accept_tos",
+  "terms": [
+    {
+      "type": "string",
+      "currentVersion": "string",
+      "name": "string",
+      "url": null,
+      "accepted": true,
+      "acceptedVersion": null,
+      "acceptedAt": null
+    }
+  ]
+}
+```
+
+    <Note>
+      UX tip: Handle ToS acceptance within the email registration flow to avoid introducing an additional screen in the onboarding process. In the same screen, render the Terms (or link to them) and include a mandatory "I agree to the Terms of Service" checkbox. Disable form submission until the checkbox is selected. After successful registration and token issuance, automatically trigger the SoF acceptance call with the new token.
+    </Note>
+
+    #### Request Terms of Service
+
+    Fetch the current `Terms of Service` that users must agree to before continuing with the onboarding process via the endpoint [`GET /terms`](/api-reference/terms/list-available-terms).
+
+    <Tabs>
+      <Tab title="Sandbox">
+```bash cURL
+curl --request GET \
+  --url https://core.sandbox.gnosispay.in/user-api/terms
+```
+      </Tab>
+      <Tab title="Production">
+```bash cURL
+curl --request GET \
+  --url https://core.prod.gnosispay.com/user-api/terms
+```
+      </Tab>
+    </Tabs>
+
+    Submit the accepted Terms of Service via the [`POST /user/terms`](/api-reference/terms/accept-terms) endpoint.
+
+    <Tabs>
+      <Tab title="Sandbox">
+```bash cURL
+curl --request POST \
+  --url https://core.sandbox.gnosispay.in/user-api/user/terms \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "terms": [
+      {
+        "type": "<string>",
+        "version": "<string>"
+      }
+    ]
+  }'
+```
+      </Tab>
+      <Tab title="Production">
+```bash cURL
+curl --request POST \
+  --url https://core.prod.gnosispay.com/user-api/user/terms \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "terms": [
+      {
+        "type": "<string>",
+        "version": "<string>"
+      }
+    ]
+  }'
+```
+      </Tab>
+    </Tabs>
+
+    You can check the status of the user's acceptance of the Terms of Service via the [`GET /user/terms`](/api-reference/terms/get-user-terms-status) endpoint.
+
+    <Tabs>
+      <Tab title="Sandbox">
+```bash cURL
+curl --request GET \
+  --url https://core.sandbox.gnosispay.in/user-api/user/terms
+```
+      </Tab>
+      <Tab title="Production">
+```bash cURL
+curl --request GET \
+  --url https://core.prod.gnosispay.com/user-api/user/terms
+```
+      </Tab>
+    </Tabs>
+  </Step>
+</Steps>
+
+## 3. KYC Process
+
+<Steps>
+  <Step title="Get onboarding status">
+    Call the [`GET /user/onboarding`](/api-reference/user/get-onboarding-status) API to retrieve the current status of the user's onboarding process. If the status is `action_complete_kyc`, you can proceed with the KYC process. The response will include the status and a `webSdkURL` for completing KYC verification.
+
+```json
+{
+    "status": "action_complete_kyc",
+    "webSdkUrl": "https://in.sumsub.com/websdk/p/sbx_yeuhsxyuhkio"
+}
+```
+  </Step>
+
+  <Step title="Complete KYC">
+    <Tabs>
+      <Tab title="Sandbox">
+        Access the Sumsub URL provided in the response to begin the KYC verification process. In the sandbox environment, you can use Sumsub's predefined templates for testing purposes.
+
+        <Note>
+          As you are in the sandbox environment, you can use fake documents or use one provided by Sumsub.
+        </Note>
+
+        To complete the verification process:
+        1. Open an iframe with the provided `webSdkUrl`
+        2. Use the [verification document templates](https://docs.sumsub.com/docs/verification-document-templates) for Proof of Identity (POI) and Proof of Address (POA)
+        3. Complete the liveness check as prompted
+      </Tab>
+      <Tab title="Production">
+        Access the Sumsub URL provided in the response to begin the KYC verification process.
+
+        To complete the verification process:
+        1. Open an iframe with the provided `webSdkUrl`
+        2. Upload valid Proof of Identity (POI) and Proof of Address (POA) documents
+        3. Complete the liveness check as prompted
+      </Tab>
+    </Tabs>
+  </Step>
+
+  <Step title="Handle KYC resubmission request">
+    If [`GET /user/onboarding`](/api-reference/user/get-onboarding-status) returns `action_kyc_resubmission_requested`, the KYC provider has reviewed the submission and is requesting the user resubmit their documents. The response shape is identical to `action_complete_kyc` and includes a fresh `webSdkUrl`:
+
+```json
+{
+    "status": "action_kyc_resubmission_requested",
+    "webSdkUrl": "https://in.sumsub.com/websdk/p/sbx_yeuhsxyuhkio"
+}
+```
+
+    Open the Sumsub iframe again with the provided `webSdkUrl` and have the user resubmit their documents, following the same steps as the initial KYC completion.
+  </Step>
+
+  <Step title="Handle KYC manual review (contact support)">
+    If [`GET /user/onboarding`](/api-reference/user/get-onboarding-status) returns `kyc_manual_review`, the KYC provider has flagged the check for manual review. This is a non-recoverable state from the user's side — no `webSdkUrl` is provided and the user cannot self-resolve it.
+
+```json
+{
+    "status": "kyc_manual_review"
+}
+```
+
+    <Warning>
+      Display a clear message directing the user to contact customer support. No further onboarding actions are available until the manual review is resolved.
+    </Warning>
+  </Step>
+
+  <Step title="Complete SOF">
+    After completing the KYC process, the next step is to proceed to the Source of Funds (SOF) verification step. Call [`GET /user/onboarding`](/api-reference/user/get-onboarding-status), which will return the next required action to complete SOF verification along with the questions that need to be answered. Alternatively, retrieve the SOF questions directly using the [`GET /source-of-funds`](/api-reference/source-of-funds/get-sof-questions) endpoint.
+
+    <Tabs>
+      <Tab title="Sandbox">
+```bash cURL
+curl --request GET \
+  --url https://core.sandbox.gnosispay.in/user-api/source-of-funds
+```
+      </Tab>
+      <Tab title="Production">
+```bash cURL
+curl --request GET \
+  --url https://core.prod.gnosispay.com/user-api/source-of-funds
+```
+      </Tab>
+    </Tabs>
+
+    Once all SOF questions have been reviewed and answered by the user, submit the responses through the [`POST /source-of-funds`](/api-reference/source-of-funds/submit-sof-answers) endpoint to complete this step of the onboarding process.
+
+    <Tabs>
+      <Tab title="Sandbox">
+```bash cURL
+curl --request POST \
+  --url https://core.sandbox.gnosispay.in/user-api/source-of-funds \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "answers": [
+      {
+        "question": "<string>",
+        "answer": "<string>"
+      }
+    ]
+  }'
+```
+      </Tab>
+      <Tab title="Production">
+```bash cURL
+curl --request POST \
+  --url https://core.prod.gnosispay.com/user-api/source-of-funds \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "answers": [
+      {
+        "question": "<string>",
+        "answer": "<string>"
+      }
+    ]
+  }'
+```
+      </Tab>
+    </Tabs>
+  </Step>
+</Steps>
+
+## 4. Account Setup
+
+<Steps>
+  <Step title="Check onboarding status">
+    Check the user's onboarding status using the [`GET /user/onboarding`](/api-reference/user/get-onboarding-status) endpoint to determine if their KYC verification has been accepted. If the KYC is approved, the user status will transition to the following:
+
+```json
+{
+    "status": "action_create_account"
+}
+```
+
+    In the next step, we will create the GP spending Safe wallet address.
+  </Step>
+
+  <Step title="Create GP Account">
+    In this step, you will initiate the Gnosis Pay account provisioning and creation process. Call [`POST /user/account`](/api-reference/user-account/create-account) endpoint to create an account for the authenticated user.
+
+    <Tabs>
+      <Tab title="Sandbox">
+```bash cURL
+curl --request POST \
+  --url https://core.sandbox.gnosispay.in/user-api/user/account \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "celoConfig": {
+      "dailyLimits": {
+        "usdt": 1,
+        "usdc": 1
+      }
+    }
+  }'
+```
+      </Tab>
+      <Tab title="Production">
+```bash cURL
+curl --request POST \
+  --url https://core.prod.gnosispay.com/user-api/user/account \
+  --header 'Content-Type: application/json' \
+  --data '{
+    "celoConfig": {
+      "dailyLimits": {
+        "usdt": 1,
+        "usdc": 1
+      }
+    }
+  }'
+```
+      </Tab>
+    </Tabs>
+
+    Once the account provisioning begins, the onboarding status will be updated to the `waiting_account_setup` state, indicating that the account is being set up in the system.
+
+```json
+{
+    "status": "waiting_account_setup"
+}
+```
+  </Step>
+
+  <Step title="Retrieve Authenticated User">
+    Call the [`GET /user`](/api-reference/user/get-current-user) endpoint to retrieve the full user profile, including their GP spending wallet address.
+
+    <Tabs>
+      <Tab title="Sandbox">
+```bash cURL
+curl --request GET \
+  --url https://core.sandbox.gnosispay.in/user-api/user \
+  --header 'Content-Type: application/json'
+```
+      </Tab>
+      <Tab title="Production">
+```bash cURL
+curl --request GET \
+  --url https://core.prod.gnosispay.com/user-api/user \
+  --header 'Content-Type: application/json'
+```
+      </Tab>
+    </Tabs>
+  </Step>
+</Steps>
+
+## 5. Phone Verification
+
+<Steps>
+  <Step title="Handle phone verification requirement">
+    Once the account has provisioned and is active, [`GET /user/onboarding`](/api-reference/user/get-onboarding-status) may return `action_verify_phone`.
+
+```json
+{
+    "status": "action_verify_phone"
+}
+```
+    Prompt the user to verify their phone number to proceed. Once verification is complete, the onboarding status will move to `completed`.
+  </Step>
+</Steps>
diff --git a/cards/assets/css-styling.png b/guides/pse/assets/css-styling.png
similarity index 100%
rename from cards/assets/css-styling.png
rename to guides/pse/assets/css-styling.png
diff --git a/guides/pse/pse-integration.mdx b/guides/pse/pse-integration.mdx
new file mode 100644
index 0000000..eba2850
--- /dev/null
+++ b/guides/pse/pse-integration.mdx
@@ -0,0 +1,501 @@
+---
+title: "PSE Integration"
+description: "Securely display and manage card data using the Gnosis Pay Payment Secure Elements (PSE) SDK"
+---
+
+<Note>
+  New to authentication on Gnosis Pay? Read [Authentication & Tokens](/concepts/auth/token) first the PSE SDK relies on a valid access token (`authModuleToken`) obtained via the [SIWE authentication flow](/guides/auth-with-siwe).
+</Note>
+
+The **Payment Secure Elements (PSE) SDK** lets you display and manage sensitive card data such as card number, expiration, CVV, and PIN directly in your application, without that data ever touching your own front-end or back-end code. Card data is rendered inside **PCI-compliant iframes** hosted by Gnosis Pay, and communicates with your app only through secure, origin-verified `postMessage` events.
+
+
+<Info>
+  PSE v3 requires a wallet signature (EIP-712) before each sensitive operation, adding a second factor on top of your `authModuleToken`. This is the current supported version.
+</Info>
+
+---
+
+## Installation
+
+Install via npm:
+
+```bash
+npm install @gnosispay/pse-sdk
+```
+
+Or load directly via CDN:
+
+```html
+<!-- For modern browsers (ES modules) -->
+<script
+  type="module"
+  src="https://unpkg.com/@gnosispay/pse-sdk@2.0.0/dist/gp-sdk.es.js"
+></script>
+
+<!-- For older browsers (UMD) -->
+<script src="https://unpkg.com/@gnosispay/pse-sdk@2.0.0/dist/gp-sdk.umd.js"></script>
+```
+
+---
+
+## Backend Setup: mTLS and the Ephemeral Token
+
+Before initializing the SDK on the front-end, your **backend** must establish a secure connection to the PSE private API to obtain an **ephemeral token**.
+
+### Secure connection using mTLS authentication
+
+**Mutual TLS (mTLS)** is a form of authentication where both parties in a connection verify each other using the TLS protocol. Your backend establishes an mTLS connection with the Gnosis Pay private PSE API to receive an ephemeral token.
+
+#### Generating mTLS certificates
+
+After signing up through the [Partners Dashboard](https://partners.gnosispay.com/), you'll receive an `App ID` instantly. Use it to generate a private key and Certificate Signing Request (CSR):
+
+```bash
+# APP_ID is a string starting with `gp_` that you have received from Gnosis Pay
+export APP_ID="gp_woop_123"
+
+# Create a private key (NEVER share with anyone)
+openssl ecparam -name prime256v1 -genkey -noout -out "${APP_ID}.key.pem"
+
+# Create the CSR (OK to share)
+openssl req -new -sha256 -key "${APP_ID}.key.pem" -out "${APP_ID}.csr.pem" -subj "/CN=${APP_ID}"
+```
+
+<Warning>
+  Share only `${APP_ID}.csr.pem` with the Gnosis Pay team. **Never** share the `.key.pem` private key file with anyone.
+</Warning>
+
+Once we receive your CSR, we'll sign it and return your signed certificates. These, along with your private key, are used to establish the mTLS connection.
+
+#### Establishing mTLS authentication (Node.js)
+
+Store your signed certificates and private key securely in your environment:
+
+```bash
+SIGNED_CERTIFICATES="-----BEGIN CERTIFICATE-----
+ABCQz ....
+-----END CERTIFICATE-----
+-----BEGIN CERTIFICATE-----
+DEFC7 ....
+-----END CERTIFICATE-----
+-----BEGIN CERTIFICATE-----
+GHICc ....
+-----END CERTIFICATE-----"
+
+PRIVATE_KEY="-----BEGIN EC PRIVATE KEY-----
+ABCD....
+-----END EC PRIVATE KEY-----"
+```
+
+<CodeGroup>
+
+```js Using Axios
+const httpsAgent = new https.Agent({
+  cert: process.env.SIGNED_CERTIFICATES,
+  key: process.env.PRIVATE_KEY,
+  rejectUnauthorized: true, // Ensure SSL verification
+});
+
+const ephemeralTokenRequest = await axios({
+  httpsAgent: httpsAgent,
+  method: "POST",
+  url: `https://api-pse.gnosispay.com/api/v1/ephemeral-token`,
+  headers: { "Content-Type": "application/json" },
+});
+```
+
+```js Using https.request
+import https from "https";
+
+const httpsAgent = new https.Agent({
+  cert: CERT,
+  key: KEY,
+  rejectUnauthorized: true,
+});
+
+const req = https.request(
+  {
+    hostname: "api-pse.gnosispay.com",
+    path: "/api/v1/ephemeral-token",
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "User-Agent": "User-Client/1.0.0",
+    },
+    agent: httpsAgent,
+  },
+  (res) => {
+    let data = "";
+    res.on("data", (chunk) => {
+      data += chunk;
+    });
+
+    res.on("end", () => {
+      console.log("Status:", res.statusCode);
+      try {
+        const parsedData = JSON.parse(data);
+        console.log("Response:", parsedData);
+      } catch {
+        console.log("Raw response:", data);
+      }
+    });
+  }
+);
+
+req.on("error", (error) => {
+  console.error("Request error:", error);
+});
+req.end();
+```
+
+</CodeGroup>
+
+<Note>
+  The ephemeral token is valid for a very short time frame. Generate a new one for every SDK usage.
+</Note>
+
+### Backend: ephemeral token relay endpoint
+
+Your backend needs an endpoint that proxies ephemeral token requests to the PSE private API using the mTLS setup above. Example using Express:
+
+```js
+import express from "express";
+import axios from "axios";
+import https from "node:https";
+
+const app = express();
+
+app.get("/api/ephemeral-token", async (_req, res) => {
+  try {
+    const cert = Buffer.from(process.env.CLIENT_CERT, "base64").toString("ascii");
+    const key = Buffer.from(process.env.CLIENT_KEY, "base64").toString("ascii");
+    const httpsAgent = new https.Agent({ cert, key, rejectUnauthorized: true });
+
+    const response = await axios({
+      method: "POST",
+      url: "https://api-pse.gnosispay.com/api/v1/ephemeral-token",
+      headers: { "Content-Type": "application/json" },
+      httpsAgent,
+    });
+
+    res.json({ data: response.data.data });
+  } catch (error) {
+    res.status(502).json({ error: "Failed to reach PSE private API" });
+  }
+});
+```
+
+`CLIENT_CERT` and `CLIENT_KEY` are the base64-encoded signed certificate and private key stored in your environment variables.
+
+---
+
+## EIP-712 Two-Factor Authentication
+
+PSE v3 requires a **wallet signature** before each sensitive operation. This acts as a second factor: even if an `authModuleToken` is compromised, an attacker cannot view card data or change a PIN without also controlling the user's wallet.
+
+### How it works
+
+Before initializing the SDK, your front-end must:
+
+1. Request a one-time **challenge** from the auth module.
+2. Ask the user's wallet to **sign** the returned EIP-712 typed data.
+3. Pass the resulting **signature** and **nonce** to the SDK constructor.
+
+The PSE service forwards both values to the auth module, which verifies the signature and marks the nonce as consumed. Each challenge is **single-use** and **expires after 5 minutes**.
+
+### Get PCI EIP-712 Challenge
+
+Issues a one-time EIP-712 challenge. The response is a complete typed-data object that can be passed directly to `signTypedData` (convert `message.nonce` to `BigInt` first).
+
+<Tabs>
+  <Tab title="Sandbox">
+```bash
+    curl --request GET \
+      --url "https://core.sandbox.gnosispay.in/user-api/pci/cards/{cardId}/challenge?action=view-details" \
+      --header 'Authorization: Bearer <authModuleToken>'
+```
+  </Tab>
+  <Tab title="Production">
+```bash
+    curl --request GET \
+      --url "https://core.prod.gnosispay.com/user-api/pci/cards/{cardId}/challenge?action=view-details" \
+      --header 'Authorization: Bearer <authModuleToken>'
+```
+  </Tab>
+</Tabs>
+
+
+<Note>
+  `message.nonce` is returned as a decimal string representing a `uint256`. Convert it to `BigInt` before passing it to `signTypedData`.
+</Note>
+
+### Signing the challenge
+
+<CodeGroup>
+
+```typescript Using wagmi
+import { useSignTypedData } from "wagmi";
+
+const { signTypedDataAsync } = useSignTypedData();
+
+// 1. Fetch the challenge (authModuleToken is sent automatically via client config)
+const { data, error } = await getPciCardsByCardIdChallenge({
+  path: { cardId },
+  query: { action: "view-details" },
+});
+
+if (error || !data) throw new Error("Failed to get EIP-712 challenge");
+
+// 2. Sign and convert nonce to BigInt for the uint256 type
+const signature = await signTypedDataAsync({
+  domain: data.domain,
+  types: data.types,
+  primaryType: data.primaryType,
+  message: {
+    authorization: data.message.authorization,
+    nonce: BigInt(data.message.nonce),
+  },
+});
+
+// 3. Pass to SDK constructor
+const eip712Signature = signature;
+const eip712Nonce = data.message.nonce; // keep as decimal string
+```
+
+```typescript Using viem directly
+import { createWalletClient, custom } from "viem";
+import { celo } from "viem/chains";
+
+const walletClient = createWalletClient({
+  chain: celo,
+  transport: custom(window.ethereum),
+});
+
+// 1. Fetch the challenge
+const response = await fetch(
+  `https://core.sandbox.gnosispay.in/user-api/pci/cards/${cardId}/challenge?action=view-details`,
+  { headers: { Authorization: `Bearer ${authModuleToken}` } }
+);
+const data = await response.json();
+
+// 2. Sign
+const [account] = await walletClient.getAddresses();
+const signature = await walletClient.signTypedData({
+  account,
+  domain: data.domain,
+  types: data.types,
+  primaryType: data.primaryType,
+  message: {
+    authorization: data.message.authorization,
+    nonce: BigInt(data.message.nonce),
+  },
+});
+
+const eip712Signature = signature;
+const eip712Nonce = data.message.nonce;
+```
+
+</CodeGroup>
+
+<Warning>
+  The challenge must be fetched **immediately before** each SDK initialization. Do not reuse a nonce across different operations or SDK instances as it will be rejected after the first use.
+</Warning>
+
+---
+
+## Initialize the SDK
+
+After completing the EIP-712 challenge/sign step above, initialize the SDK with `pseVersion: 3`:
+
+```typescript
+import GPSDK, { ElementType } from "@gnosispay/pse-sdk";
+
+// 1. Get the auth module access token from your SIWE auth flow
+const authModuleToken = getAccessToken(); // your auth implementation
+
+// 2. Fetch ephemeral token from your backend
+const response = await fetch("/api/ephemeral-token");
+const { data } = await response.json();
+
+// 3. Fetch and sign an EIP-712 challenge (see section above)
+//    Use the action matching the operation you are about to perform:
+//    "view-details" | "view-pin" | "change-pin"
+const { eip712Signature, eip712Nonce } = await getSignedChallenge(cardId, "view-details");
+
+// 4. Initialize the SDK with PSE version 3
+const gpSdk = new GPSDK({
+  pseVersion: 3,                          // PSE version 3, required for EIP-712 2FA
+  appId: "gp_your_app_id",               // Your Partner App ID
+  ephemeralToken: data.ephemeralToken,
+  authModuleToken: authModuleToken,       // Auth module access token
+  eip712Signature: eip712Signature,       // Hex signature from wallet
+  eip712Nonce: eip712Nonce,               // Decimal nonce string from challenge
+  onActionSuccess: (action) => {
+    console.log("Action completed:", action);
+  },
+  onInvalidToken: (message) => {
+    console.error("Token invalid:", message);
+    // Refresh the ephemeral token and reinitialize
+  },
+  onError: (message, details) => {
+    console.error("PSE error:", message, details);
+  },
+});
+```
+
+<Warning>
+  The `authModuleToken` expires every 15 minutes. Handle the `onInvalidToken` callback to refresh your access token via the [Authenticating with SIWE](guides/auth-with-siwe#refresh-access-token) flow and re-initialize the SDK.
+</Warning>
+
+### Display card details
+
+Use `ElementType.CardData` to display the full card number, expiration date, and security code.
+
+<Note>
+  Use `action: "view-details"` when fetching the EIP-712 challenge for this element.
+</Note>
+
+```typescript
+// cardId is a UUID obtained from GET /cards
+const { destroy } = gpSdk.init(ElementType.CardData, "#card-data-container", {
+  cardId: "019c9578-a8ce-7445-9961-51b945605f70",
+});
+
+// Call destroy() when unmounting or cleaning up
+destroy();
+```
+
+### View card PIN
+
+Use `ElementType.CardPin` to display the card's current PIN inside the secure iframe.
+
+<Note>
+  Use `action: "view-pin"` when fetching the EIP-712 challenge for this element.
+</Note>
+
+```typescript
+// Fetch and sign the challenge with action "view-pin" before constructing the SDK
+const { eip712Signature, eip712Nonce } = await getSignedChallenge(cardId, "view-pin");
+
+const gpSdk = new GPSDK({
+  pseVersion: 3,
+  appId: "gp_your_app_id",
+  ephemeralToken: data.ephemeralToken,
+  authModuleToken: authModuleToken,
+  eip712Signature,
+  eip712Nonce,
+  onActionSuccess: (action) => { /* ... */ },
+  onInvalidToken: (message) => { /* ... */ },
+  onError: (message, details) => { /* ... */ },
+});
+
+const { destroy } = gpSdk.init(ElementType.CardPin, "#pin-container", {
+  cardId: "019c9578-a8ce-7445-9961-51b945605f70",
+});
+```
+
+### Set / change card PIN
+
+Use `ElementType.SetCardPin` to render a PIN entry form that lets the cardholder set or change their PIN.
+
+<Note>
+  Use `action: "change-pin"` when fetching the EIP-712 challenge for this element.
+</Note>
+
+```typescript
+// Fetch and sign the challenge with action "change-pin" before constructing the SDK
+const { eip712Signature, eip712Nonce } = await getSignedChallenge(cardId, "change-pin");
+
+const gpSdk = new GPSDK({
+  pseVersion: 3,
+  appId: "gp_your_app_id",
+  ephemeralToken: data.ephemeralToken,
+  authModuleToken: authModuleToken,
+  eip712Signature,
+  eip712Nonce,
+  onActionSuccess: (action) => {
+    // Fired with Action.SetPin when the user submits the new PIN,
+    // and Action.DoneSettingPin when the operation is confirmed.
+    console.log("PIN operation completed:", action);
+  },
+  onInvalidToken: (message) => { /* ... */ },
+  onError: (message, details) => { /* ... */ },
+});
+
+const { destroy } = gpSdk.init(ElementType.SetCardPin, "#set-pin-container", {
+  cardId: "019c9578-a8ce-7445-9961-51b945605f70",
+});
+```
+
+### Refresh the ephemeral token
+
+If the current ephemeral token has expired, you'll receive an `onInvalidToken` callback. Refresh it without re-creating the SDK instance:
+
+```typescript
+const newToken = await fetchNewEphemeralToken();
+gpSdk.refreshToken(newToken);
+```
+
+---
+
+## Available Elements
+
+| Element | Description |
+|---|---|
+| `ElementType.CardData` | Read credit card number, expiration date and CVV |
+| `ElementType.CardPin` | Read PIN of credit card |
+| `ElementType.SetCardPin` | Set PIN of credit card |
+| `ElementType.CardExpirationCopied` | User copied card expiration date |
+| `ElementType.CardSecurityCodeCopied` | User copied card security code |
+| `ElementType.CardNumberCopied` | User copied card number |
+
+Each element is rendered in a secure iframe to ensure PCI compliance.
+
+## Element Lifecycle
+
+Elements can be initialized and destroyed:
+
+```js
+const cardDataContainer = gpSdk.init(
+  ElementType.CardData,
+  "#card-data-container",
+  {
+    cardId: "your-card-id",
+  }
+);
+
+// When you're done with the element
+cardDataContainer.destroy();
+```
+
+## Callbacks
+
+The SDK provides callbacks to handle events from the iframe elements:
+
+| Callback | Trigger |
+|----------|---------|
+| `onActionSuccess(action)` | A user action completes (e.g., `CardNumberCopied`, `SetPin`, `DoneSettingPin`) |
+| `onInvalidToken(message)` | The ephemeral token has expired or is invalid |
+| `onError(message, details)` | An error occurred inside the iframe |
+
+---
+
+## Customizing Element Styling
+
+For security reasons, the only way to apply custom styling to iframe elements is to prepare and share a **CSS file** with the Gnosis Pay team. This file, named `<partner_name>.css`, will be incorporated into the iframe.
+
+Standard styling is applied to iframe elements by default. Selectors you can override include:
+
+- `.pse-container` : shared class for all iframe containers
+- `#pse-card-data-container` : main container for displaying card data
+- `.pse-card-field` : container for each card data field (card number, expiry date, security code)
+- `.pse-card-label` : labels for each field
+- `.pse-card-value` : container for the actual card data values
+
+### Styling workflow
+
+1. In your front-end, load the element you wish to customize (e.g., the card data).
+2. Locate the custom CSS file with your name in either the "**Style Editor**" in Firefox or the "**Sources**" panel in Chrome/Brave (e.g., `gnosis_pay_ui.css`).
+3. Apply your desired styling changes reflect immediately in your interface.
+4. Save the file and send it to Gnosis Pay for application in production.
diff --git a/guides/pse/pse.mdx b/guides/pse/pse.mdx
new file mode 100644
index 0000000..7a3d00c
--- /dev/null
+++ b/guides/pse/pse.mdx
@@ -0,0 +1,60 @@
+---
+title: Partner Secure Elements (PSE)
+description: Display sensitive card information and manage PINs securely in your client application using PSE SDK (PSE version 3 with EIP-712 two-factor authentication).
+---
+
+## Overview
+
+If you want to display sensitive information (such as card numbers or PINs) in your front-end, you'll need to interact with our **Partner Secure Elements (PSE)** service. The easiest way to do this is by using the [PSE SDK](https://www.npmjs.com/package/@gnosispay/pse-sdk) from Gnosis Pay.
+
+To initialize the SDK, you'll need:
+- An `App ID` provided to you upon registration with Gnosis Pay
+- An **ephemeral-token** retrieved from the PSE private API using mTLS authentication
+- An **auth module token** obtained through the [SIWE authentication flow](/guides/auth-with-siwe)
+- An **EIP-712 signature** and **nonce** obtained from the challenge flow described below
+
+<Info>
+  **PSE version 3** adds an EIP-712 wallet signature as a second factor for every sensitive operation. Pass `pseVersion: 3` when constructing the SDK and include `eip712Signature` and `eip712Nonce` obtained from the challenge flow described below.
+
+  Note: `pseVersion` refers to the PSE SDK protocol version and is unrelated to the Gnosis Pay API path (which remains `/v2`).
+</Info>
+
+<Warning>
+  **Backend Required**: mTLS authentication can only be performed from a
+  back-end. You need a back-end responsible for retrieving the
+  ephemeral-token and sending it to your front-end upon request. We'll go
+  through each step in this guide.
+</Warning>
+
+Once your front-end has the ephemeral-token and auth module token, it can initialize the PSE SDK and use it to display secure elements.
+
+Here's a diagram showing each step:
+
+```mermaid
+    sequenceDiagram
+        participant FE as Your Frontend
+        participant BE as Your Backend
+        participant Auth as Auth Module
+        participant PSE as PSE API
+
+        FE->>Auth: SIWE Login
+        Auth-->>FE: authModuleToken (15min access token)
+
+        FE->>BE: Request ephemeral-token
+        BE->>PSE: POST /api/v1/ephemeral-token (mTLS)
+        PSE-->>BE: ephemeral-token
+        BE-->>FE: ephemeral-token
+
+        FE->>Auth: GET /pci/cards/{cardId}/challenge?action=...
+        Auth-->>FE: EIP-712 typed data (domain, types, message, nonce)
+        Note over FE: User signs typed data in wallet
+
+        Note over FE: Initialize PSE SDK (PSE version 3) with<br/>ephemeralToken, authModuleToken, appId,<br/>eip712Signature, eip712Nonce
+
+        FE->>PSE: SDK requests card data
+        PSE->>Auth: Verifies EIP-712 signature + nonce
+        Auth-->>PSE: Signature valid
+        PSE-->>FE: Renders card data in secure iframe
+```
+
+---
diff --git a/guides/webhooks/partner-webhook.png b/guides/webhooks/partner-webhook.png
new file mode 100644
index 0000000..7b9e0df
Binary files /dev/null and b/guides/webhooks/partner-webhook.png differ
diff --git a/guides/webhooks/webhook-events.mdx b/guides/webhooks/webhook-events.mdx
new file mode 100644
index 0000000..c557451
--- /dev/null
+++ b/guides/webhooks/webhook-events.mdx
@@ -0,0 +1,672 @@
+---
+title: "Webhook Events"
+description: "Complete list of webhook events triggered in V2"
+---
+
+## Account Events
+
+### 1. Account.balance.changed
+
+Triggered when the account balance changes.
+
+#### Event Trigger Points
+
+| Flow                          | Reason Value                    |
+| ----------------------------- | ------------------------------- |
+| Deposit approved              | `deposit.approved`              |
+| Deposit rejected              | `deposit.rejected`              |
+| Withdrawal completed          | `withdrawal.completed`          |
+| Instant withdrawal reconciled | `withdrawal.completed`          |
+| Card authorization            | `card.authorization.{category}` |
+
+<CodeGroup>
+```typescript account.balance.changed
+{
+   "id": "evt_abc123def456...",
+   "type": "account.balance.changed",
+   "createdAt": "2026-03-30T12:00:00.000000000Z",
+   "data": {
+     "accountId": "550e8400-e29b-41d4-a716-446655440000",
+     "reason": "deposit.approved",
+     "referenceId": "ref-123",
+     "balances": [
+       {
+         "currency": "EUR",
+         "decimals": 18,
+         "spendable": "1000000000000000000",
+         "nonSpendable": "500000000000000000",
+         "processingDeposits": "200000000000000000",
+         "processingWithdrawals": "100000000000000000"
+       },
+       {
+         "currency": "GBP",
+         "decimals": 18,
+         "spendable": "0",
+         "nonSpendable": "0",
+         "processingDeposits": "0",
+         "processingWithdrawals": "0"
+       },
+       {
+         "currency": "USD",
+         "decimals": 6,
+         "spendable": "1000000",
+         "nonSpendable": "50000",
+         "processingDeposits": "100000",
+         "processingWithdrawals": "0"
+       }
+     ]
+   }
+ }
+```
+</CodeGroup>
+
+### 2. Account.created
+
+Triggered when a new account is created and provisioning begins.
+
+<CodeGroup>
+```typescript account.created
+{
+  "id": "evt_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
+  "type": "account.created",
+  "createdAt": "2026-03-11T14:30:00.123456789Z",
+  "data": {
+    "id": "019505a1-b2c3-7d4e-a5f6-a1b2c3d4e5f6",
+    "kycProfileId": "019505a1-c3d4-7e5f-b6a7-b2c3d4e5f6a7",
+    "safeOwnerAddress": "0x1234567890abcdef1234567890abcdef12345678",
+    "safeAddress": null,
+    "chain": {
+      "name": "gnosis",
+      "id": "100"
+    },
+    "reference": null,
+    "nativeCurrency": "EUR",
+    "additionalCurrencies": ["GBP"],
+    "createdAt": "2026-03-11T14:30:00.123456789Z",
+    "updatedAt": "2026-03-11T14:30:00.123456789Z",
+    "closedAt": null,
+    "status": "provisioning",
+    "provisionedAt": null
+  }
+}
+```
+</CodeGroup>
+
+### 3. Account.activated
+
+Triggered when account provisioning is complete and account becomes active.
+
+<CodeGroup>
+```typescript account.activated
+{
+  "id": "evt_b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7",
+  "type": "account.activated",
+  "createdAt": "2026-03-11T15:00:00.123456789Z",
+  "data": {
+    "id": "019505a1-b2c3-7d4e-a5f6-a1b2c3d4e5f6",
+    "kycProfileId": "019505a1-c3d4-7e5f-b6a7-b2c3d4e5f6a7",
+    "safeOwnerAddress": "0x1234567890abcdef1234567890abcdef12345678",
+    "safeAddress": "0xabcdef1234567890abcdef1234567890abcdef12",
+    "chain": {
+      "name": "gnosis",
+      "id": "100"
+    },
+    "reference": "partner-ref-123",
+    "nativeCurrency": "EUR",
+    "additionalCurrencies": ["GBP"],
+    "createdAt": "2026-03-11T14:30:00.123456789Z",
+    "updatedAt": "2026-03-11T15:00:00.123456789Z",
+    "closedAt": null,
+    "status": "active",
+    "provisionedAt": "2026-03-11T14:45:00.123456789Z"
+  }
+}
+```
+</CodeGroup>
+
+### 4. Account.blocked
+
+Triggered when an account is blocked due to security or compliance reasons.
+
+<CodeGroup>
+```typescript account.blocked
+{
+  "id": "evt_c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8",
+  "type": "account.blocked",
+  "createdAt": "2026-03-11T16:00:00.123456789Z",
+  "data": {
+    "id": "019505a1-b2c3-7d4e-a5f6-a1b2c3d4e5f6",
+    "kycProfileId": "019505a1-c3d4-7e5f-b6a7-b2c3d4e5f6a7",
+    "safeOwnerAddress": "0x1234567890abcdef1234567890abcdef12345678",
+    "safeAddress": "0xabcdef1234567890abcdef1234567890abcdef12",
+    "chain": {
+      "name": "gnosis",
+      "id": "100"
+    },
+    "reference": "partner-ref-123",
+    "nativeCurrency": "EUR",
+    "additionalCurrencies": ["GBP"],
+    "createdAt": "2026-03-11T14:30:00.123456789Z",
+    "updatedAt": "2026-03-11T16:00:00.123456789Z",
+    "closedAt": null,
+    "status": "blocked",
+    "provisionedAt": "2026-03-11T14:45:00.123456789Z"
+  }
+}
+```
+</CodeGroup>
+
+## KYC Events
+
+### 5. KYC.profile.approved
+
+Triggered when a KYC profile verification is approved.
+
+<CodeGroup>
+```typescript kyc.profile.approved
+{
+  "id": "evt_d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9",
+  "type": "kyc.profile.approved",
+  "createdAt": "2026-03-11T14:00:00.123456789Z",
+  "data": {
+    "id": "019505a1-c3d4-7e5f-b6a7-b2c3d4e5f6a7",
+    "reference": "applicant-abc123",
+    "email": "user@example.com",
+    "status": "approved",
+    "tenantId": "tenant-xyz",
+    "details": {
+      "fullName": "John Doe",
+      "phoneNumber": "+441234567890",
+      "dateOfBirth": "1990-01-15T00:00:00Z",
+      "nationality": "GB",
+      "countryOfResidence": "GB",
+      "countryOfBirth": "GB",
+      "documentNumber": "AB123456C",
+      "gender": "male",
+      "addresses": [
+        {
+          "id": "019505a1-e5f6-7a7b-c8d9-e0f1a2b3c4d5",
+          "country": "GB",
+          "postalCode": "SW1A 1AA",
+          "city": "London",
+          "state": "England",
+          "address1": "10 Downing Street",
+          "address2": null
+        }
+      ]
+    }
+  }
+}
+```
+</CodeGroup>
+
+### 6. KYC.profile.rejected
+
+Triggered when a KYC profile verification is rejected.
+
+<CodeGroup>
+```typescript kyc.profile.rejected
+{
+  "id": "evt_e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0",
+  "type": "kyc.profile.rejected",
+  "createdAt": "2026-03-11T14:00:00.123456789Z",
+  "data": {
+    "id": "019505a1-c3d4-7e5f-b6a7-b2c3d4e5f6a7",
+    "reference": "applicant-abc123",
+    "email": "user@example.com",
+    "status": "rejected",
+    "tenantId": "tenant-xyz",
+    "details": {
+      "fullName": "John Doe",
+      "phoneNumber": "+441234567890",
+      "dateOfBirth": "1990-01-15T00:00:00Z",
+      "nationality": "GB",
+      "countryOfResidence": "GB",
+      "countryOfBirth": "GB",
+      "documentNumber": "AB123456C",
+      "gender": "male",
+      "addresses": [
+        {
+          "id": "019505a1-e5f6-7a7b-c8d9-e0f1a2b3c4d5",
+          "country": "GB",
+          "postalCode": "SW1A 1AA",
+          "city": "London",
+          "state": "England",
+          "address1": "10 Downing Street",
+          "address2": null
+        }
+      ]
+    }
+  }
+}
+```
+</CodeGroup>
+
+### 7. KYC.profile.requires_action
+
+Triggered when a KYC profile requires additional action from the user.
+
+<CodeGroup>
+```typescript kyc.profile.requires_action
+{
+  "id": "evt_f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1",
+  "type": "kyc.profile.requires_action",
+  "createdAt": "2026-03-11T14:00:00.123456789Z",
+  "data": {
+    "id": "019505a1-c3d4-7e5f-b6a7-b2c3d4e5f6a7",
+    "reference": "applicant-abc123",
+    "email": "user@example.com",
+    "status": "requires_action",
+    "tenantId": "tenant-xyz",
+    "details": null
+  }
+}
+```
+</CodeGroup>
+
+### 8. KYC.profile.resubmission_requested
+
+Triggered when KYC profile requires document resubmission.
+
+<CodeGroup>
+```typescript kyc.profile.resubmission_requested
+{
+  "id": "evt_a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2",
+  "type": "kyc.profile.resubmission_requested",
+  "createdAt": "2026-03-11T14:00:00.123456789Z",
+  "data": {
+    "id": "019505a1-c3d4-7e5f-b6a7-b2c3d4e5f6a7",
+    "reference": "applicant-abc123",
+    "email": "user@example.com",
+    "status": "resubmission_requested",
+    "tenantId": "tenant-xyz",
+    "details": null
+  }
+}
+```
+</CodeGroup>
+
+### 9. KYC.terms.approved
+
+Triggered when all required terms are accepted.
+
+<CodeGroup>
+```typescript kyc.terms.approved
+{
+  "id": "evt_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
+  "type": "kyc.terms.approved",
+  "createdAt": "2026-03-17T10:30:00.000000000Z",
+  "data": {
+    "profileId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
+    "checkType": "terms",
+    "status": "approved",
+    "reference": "partner-user-ref-123"
+  }
+}
+```
+</CodeGroup>
+
+### 10. KYC.source_of_funds.approved
+
+Triggered when source of funds questionnaire is submitted and approved.
+
+<CodeGroup>
+```typescript kyc.source_of_funds.approved
+{
+  "id": "evt_b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7",
+  "type": "kyc.source_of_funds.approved",
+  "createdAt": "2026-03-17T10:35:00.000000000Z",
+  "data": {
+    "profileId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
+    "checkType": "source_of_funds",
+    "status": "approved",
+    "reference": "partner-user-ref-123"
+  }
+}
+```
+</CodeGroup>
+
+## Deposit Events
+
+### 11. Deposit.pending
+
+Triggered when an on-chain deposit is detected and awaiting KYT processing.
+
+<CodeGroup>
+```typescript deposit.pending
+{
+  "id": "evt_c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8",
+  "type": "deposit.pending",
+  "createdAt": "2026-03-17T11:00:00.000000000Z",
+  "data": {
+    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+    "accountId": "d4e5f6a7-b8c9-0123-4567-890abcdef012",
+    "status": "pending",
+    "amount": "1000000",
+    "currency": "USDCe",
+    "decimals": 6,
+    "transactionHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
+    "chain": {
+      "name": "gnosis",
+      "id": "100"
+    },
+    "createdAt": "2026-03-17T10:59:30.000000000Z"
+  }
+}
+```
+</CodeGroup>
+
+### 12. Deposit.approved
+
+Triggered when a deposit is confirmed after KYT and funds become available.
+
+<CodeGroup>
+```typescript deposit.approved
+{
+  "id": "evt_d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9",
+  "type": "deposit.approved",
+  "createdAt": "2026-03-17T11:00:00.000000000Z",
+  "data": {
+    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+    "accountId": "d4e5f6a7-b8c9-0123-4567-890abcdef012",
+    "status": "approved",
+    "amount": "1000000",
+    "currency": "USDCe",
+    "decimals": 6,
+    "transactionHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
+    "chain": {
+      "name": "gnosis",
+      "id": "100"
+    },
+    "createdAt": "2026-03-17T10:59:30.000000000Z"
+  }
+}
+```
+</CodeGroup>
+
+### 13. Deposit.rejected
+
+Triggered when a deposit is rejected by KYT.
+
+<CodeGroup>
+```typescript deposit.rejected
+{
+  "id": "evt_e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0",
+  "type": "deposit.rejected",
+  "createdAt": "2026-03-17T11:00:00.000000000Z",
+  "data": {
+    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+    "accountId": "d4e5f6a7-b8c9-0123-4567-890abcdef012",
+    "status": "rejected",
+    "amount": "1000000",
+    "currency": "USDCe",
+    "decimals": 6,
+    "transactionHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
+    "chain": {
+      "name": "gnosis",
+      "id": "100"
+    },
+    "createdAt": "2026-03-17T10:59:30.000000000Z"
+  }
+}
+```
+</CodeGroup>
+
+## Withdrawal Events
+
+### 14. Withdrawal.completed
+
+Triggered when a withdrawal is successfully processed on-chain.
+
+<CodeGroup>
+```typescript withdrawal.completed
+{
+  "id": "evt_f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1",
+  "type": "withdrawal.completed",
+  "createdAt": "2026-03-17T12:15:00.000000000Z",
+  "data": {
+    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
+    "accountId": "d4e5f6a7-b8c9-0123-4567-890abcdef012",
+    "status": "completed",
+    "amount": "500000",
+    "currency": "USDCe",
+    "decimals": 6,
+    "transactionHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
+    "chain": {
+      "name": "gnosis",
+      "id": "100"
+    },
+    "createdAt": "2026-03-17T12:10:00.000000000Z"
+  }
+}
+```
+</CodeGroup>
+
+### 15. Withdrawal.failed
+
+Triggered when a withdrawal fails at any stage.
+
+<CodeGroup>
+```typescript withdrawal.failed
+{
+  "id": "evt_a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2",
+  "type": "withdrawal.failed",
+  "createdAt": "2026-03-17T12:15:00.000000000Z",
+  "data": {
+    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
+    "accountId": "d4e5f6a7-b8c9-0123-4567-890abcdef012",
+    "status": "failed",
+    "amount": "500000",
+    "currency": "USDCe",
+    "decimals": 6,
+    "transactionHash": "",
+    "chain": {
+      "name": "gnosis",
+      "id": "100"
+    },
+    "createdAt": "2026-03-17T12:10:00.000000000Z"
+  }
+}
+```
+</CodeGroup>
+
+## Card Events
+
+### 16. Card.created
+
+Triggered when a virtual card is provisioned or physical card reaches pending activation.
+
+<CodeGroup>
+```typescript card.created
+{
+  "id": "evt_b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3",
+  "type": "card.created",
+  "createdAt": "2026-03-17T14:00:00.000000000Z",
+  "data": {
+    "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
+    "accountId": "d4e5f6a7-b8c9-0123-4567-890abcdef012",
+    "type": "virtual",
+    "status": "created",
+    "last4": "4321",
+    "createdAt": "2026-03-17T14:00:00.000000000Z"
+  }
+}
+```
+</CodeGroup>
+
+### 17. Card.activated
+
+Triggered when a physical card is activated.
+
+<CodeGroup>
+```typescript card.activated
+{
+  "id": "evt_c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4",
+  "type": "card.activated",
+  "createdAt": "2026-03-17T15:00:00.000000000Z",
+  "data": {
+    "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
+    "accountId": "d4e5f6a7-b8c9-0123-4567-890abcdef012",
+    "type": "plastic",
+    "status": "activated",
+    "last4": "4321",
+    "createdAt": "2026-03-17T14:00:00.000000000Z"
+  }
+}
+```
+</CodeGroup>
+
+### 18. Card.blocked
+
+Triggered when a card is temporarily blocked.
+
+<CodeGroup>
+```typescript card.blocked
+{
+  "id": "evt_d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5",
+  "type": "card.blocked",
+  "createdAt": "2026-03-17T15:30:00.000000000Z",
+  "data": {
+    "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
+    "accountId": "d4e5f6a7-b8c9-0123-4567-890abcdef012",
+    "type": "virtual",
+    "status": "blocked",
+    "last4": "4321",
+    "createdAt": "2026-03-17T14:00:00.000000000Z"
+  }
+}
+```
+</CodeGroup>
+
+### 19. Card.unblocked
+
+Triggered when a card is unblocked and restored to active status.
+
+<CodeGroup>
+```typescript card.unblocked
+{
+  "id": "evt_e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6",
+  "type": "card.unblocked",
+  "createdAt": "2026-03-17T16:00:00.000000000Z",
+  "data": {
+    "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
+    "accountId": "d4e5f6a7-b8c9-0123-4567-890abcdef012",
+    "type": "virtual",
+    "status": "unblocked",
+    "last4": "4321",
+    "createdAt": "2026-03-17T14:00:00.000000000Z"
+  }
+}
+```
+</CodeGroup>
+
+### 20. Card.canceled
+
+Triggered when a card is permanently canceled.
+
+<CodeGroup>
+```typescript card.canceled
+{
+  "id": "evt_f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7",
+  "type": "card.canceled",
+  "createdAt": "2026-03-17T16:30:00.000000000Z",
+  "data": {
+    "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
+    "accountId": "d4e5f6a7-b8c9-0123-4567-890abcdef012",
+    "type": "virtual",
+    "status": "canceled",
+    "last4": "4321",
+    "createdAt": "2026-03-17T14:00:00.000000000Z"
+  }
+}
+```
+</CodeGroup>
+
+## Card Transaction Events
+
+The following table shows all card transaction event types and when they are triggered:
+
+| Event Type                                       | When It Fires                                        | Pismo Category                                              |
+| ------------------------------------------------ | ---------------------------------------------------- | ----------------------------------------------------------- |
+| `card.transaction.created`                       | New debit authorization (purchase, withdrawal, etc.) | AUTHORIZATION (debit processing codes)                      |
+| `card.transaction.refund`                        | Credit voucher authorization (refund to cardholder)  | AUTHORIZATION (credit processing codes: 20, 203100, PSM007) |
+| `card.transaction.declined`                      | Authorization denied by Pismo                        | DECLINED                                                    |
+| `card.transaction.cleared`                       | Transaction settled/cleared (B2 confirmation)        | CONFIRMATION, AIRPORT_TAX, INSTALLMENT                      |
+| `card.transaction.reversed`                      | Full cancellation of an authorization                | CANCELLATION                                                |
+| `card.transaction.replacement`                   | Amount adjustment on a pending authorization         | REPLACEMENT                                                 |
+| `card.transaction.incremental`                   | Additional authorization amount added                | INCREMENTAL                                                 |
+| `card.transaction.partial_cancellation`          | Partial reversal of an authorization                 | PARTIAL_CANCELLATION                                        |
+| `card.transaction.cancellation_reversal`         | Undo of a previous cancellation                      | CANCELLATION_REVERSAL                                       |
+| `card.transaction.reversal_partial_cancellation` | Undo of a previous partial cancellation              | REVERSAL_PARTIAL_CANCELLATION                               |
+
+### 21. Card.transaction.created
+
+Triggered when a new debit authorization occurs (purchase, withdrawal, etc.).
+
+<CodeGroup>
+```typescript card.transaction.created
+{
+  "id": "evt_8a3c1d4f2b6e9870c2a5b4d6e8f0a1c3",
+  "type": "card.transaction.declined",
+  "createdAt": "2026-04-24T11:17:44.082000000Z",
+  "data": {
+    "id": "f1c84a96-3d05-4b6b-9f1a-b2e7c5d8a012",
+    "accountId": "12c4a7e2-7a91-4f4f-9e76-1c9e1c2a2b18",
+    "cardId": "8a3b2c91-4d7e-49ab-bf25-ef019a4e6b20",
+    "status": "declined",
+    "amount": "20",
+    "currency": "EUR",
+    "decimals": 2,
+    "originalAmount": "20",
+    "originalCurrency": "USD",
+    "originalDecimals": 2,
+    "isCredit": false,
+    "createdAt": "2026-04-24T11:17:43.000000000Z",
+    "updatedAt": "2026-04-24T11:17:43.000000000Z",
+    "description": "Kindle Svcs  888-802-3080 US",
+    "authorizationId": 717,
+    "authorizationCode": "XZ0COI",
+    "merchant": {
+      "name": "Kindle Svcs",
+      "city": "888-802-3080",
+      "country": "US",
+      "categoryCode": "5818"
+    },
+    "entryMode": "0100",
+    "country": null,
+    "billing": {
+      "billingAmount": "20",
+      "billingCurrency": {
+        "symbol": "€",
+        "code": "EUR",
+        "decimals": 2,
+        "name": "Euro"
+      }
+    },
+    "transactionCurrency": {
+      "symbol": "$",
+      "code": "USD",
+      "decimals": 2,
+      "name": "US Dollar"
+    },
+    "cardToken": "8a3b2c91-4d7e-49ab-bf25-ef019a4e6b20",
+    "wallet": {
+          "provider": "apple_pay",
+          "deviceName": "aVBhZCAoMyk.",
+          "deviceType": "TABLET",
+          "deviceBrand": null,
+          "deviceModel": null
+        },
+    "clearedAt": null,
+    "isPending": false,
+    "kind": "payment",
+    "transactionType": "0100",
+    "transactions": [],
+    "declineReason": {
+        "code": "810",
+        "message": "Insufficient balance"
+      }
+  }
+}
+```
+</CodeGroup>
diff --git a/guides/webhooks/webhook.mdx b/guides/webhooks/webhook.mdx
new file mode 100644
index 0000000..1d0036f
--- /dev/null
+++ b/guides/webhooks/webhook.mdx
@@ -0,0 +1,90 @@
+---
+title: "Introduction to Webhooks"
+description: "Step-by-step guide to set up and implement webhooks in your application with Partner Dashboard"
+---
+
+Webhooks provide real-time notifications when events happen in the Gnosis Pay system. Rather than constantly polling our APIs for updates, you can configure webhook endpoints to receive instant notifications about card transactions, account status and balances, kyc statuses, and more.
+
+
+## Enable Webhooks
+
+To implement webhooks in your application, follow these essential steps:
+
+<Steps titleSize="h3">
+<Step title="Configure Your Endpoint">
+Create a publicly accessible HTTP endpoint in your application that can receive POST requests. This endpoint must be available over HTTPS and return a 2xx status code to acknowledge receipt of webhook events.
+
+<Warning>
+Your webhook endpoint must be publicly accessible. For local development, use tools like [ngrok](https://ngrok.com/) to expose your local server.
+</Warning>
+</Step>
+
+<Step title="Configure Webhooks in Partner Dashboard">
+Configure your webhook endpoint URL directly through the **Partners Dashboard**. Provide the complete HTTPS URL where you want to receive webhook notifications.
+![Partner Dashboard](guides/webhooks/partner-webhook.png)
+<Tabs>
+    <Tab title="Sandbox">
+        ```
+        https://partner-dashboard.sandbox.gnosispay.com/
+        ```
+    </Tab>
+</Tabs>
+
+</Step>
+
+<Step title="Receive and Verify Events">
+When events happen in the Gnosis Pay system, we'll send HTTP POST requests to your webhook endpoint with event data and cryptographic signatures.
+
+All webhooks include cryptographic signatures using **Ed25519 asymmetric cryptography**:
+
+- **`X-Webhook-Timestamp`**: Unix timestamp when the webhook was sent
+- **`X-Webhook-Signature`**: Base64-encoded Ed25519 signature
+
+<Warning>
+  **Always verify webhook signatures** before processing events. This ensures
+  the webhook originated from Gnosis Pay and hasn't been tampered with.
+</Warning>
+
+
+</Step>
+
+<Step title="Parse and Process Event Data">
+Extract the `Type` and `data` fields from the webhook payload. The `Type` identifies what happened (e.g., `user.created`, `kyc.status.changed`), while `data` contains the complete entity information.
+
+```json
+{
+  "id": "evt_a1b2c3d4e5f6...",
+  "type": "account.balance.changed",
+  "createdAt": "2026-03-04T12:00:00.000Z",
+  "data": {
+    "accountId": "550e8400-e29b-41d4-a716-446655440000",
+    "balances": [
+    ]
+    ....
+  }
+}
+```
+
+Handle each event type appropriately in your application. Since we send complete entity data, you typically won't need additional API calls to get the full context.
+
+<Info>
+Process events idempotently to handle potential duplicates, and implement proper error handling and logging for monitoring.
+</Info>
+
+<Info>
+**Retry Policy**:
+- **Max attempts**: 5 retries
+- **Timeout**: 30 seconds per request
+- **4xx responses**: Treated as permanent failures (no retry) - endpoint misconfiguration
+- **5xx/connection errors**: Retried up to maximum attempts
+- **Config changes**: Jobs cancelled if webhook config is paused/deleted during delivery
+
+If your webhook endpoint returns a non-2xx status code, we'll retry delivery according to these rules.
+</Info>
+
+<Warning>
+  **Timeout**: Your webhook endpoint must respond within 30 seconds. Requests that exceed this timeout are considered failed and will trigger our retry mechanism.
+</Warning>
+
+</Step>
+</Steps>
diff --git a/index.mdx b/index.mdx
index 723fa91..327a9ef 100644
--- a/index.mdx
+++ b/index.mdx
@@ -1,71 +1,85 @@
 ---
-title: "Introduction"
-description: "Welcome to GnosisPay Documentation"
+title: "Gnosis Pay"
+description: "White-label infrastructure for instant card issuance, fiat rails, and multi-currency accounts"
+mode: "custom"
 ---
 
-This documentation is designed to help developers and businesses leverage our APIs
-to enable seamless card issuance, management, and user experiences for their customers.
+<div
+  style={{
+    backgroundImage: "linear-gradient(rgba(7,5,44,0.55), rgba(7,5,44,0.55)), url('/static/img/hero-visual.png')",
+    backgroundSize: "150% auto",
+    backgroundPosition: "20% center",
+    borderRadius: "20px",
+    padding: "56px 40px",
+    maxWidth: "1100px",
+    margin: "40px auto 0"
+  }}
+>
 
-With Gnosis Pay, you can offer your users a simple way to interact with crypto payments in the real world while enjoying
-the security of self-custodial wallets. By following the steps in this guide, you can ship stablecoin program for users and allow them to spend crypto.
+  <div style={{ marginBottom: "40px" }}>
+    <img
+      src="/static/img/logo-light.svg"
+      alt="Gnosis Pay"
+      style={{ height: "36px" }}
+    />
+  </div>
 
-<Card
-  title="Get Started Today"
-  icon="rocket"
-  href="https://my.gnosispay.com/"
->
-  Get a Gnosis Pay account today by signing in to the Gnosis Pay webapp and start spending crypto in the real world.
-</Card>
+  <div style={{ maxWidth: "700px" }}>
+    <h1 style={{ fontSize: "56px", lineHeight: "1.05", fontWeight: 800, margin: 0, color: "#FFFFFF" }}>
+      Ship stablecoin<br />card programs<br />in minutes
+    </h1>
+    <p style={{ fontSize: "18px", marginTop: "20px", maxWidth: "440px", color: "rgba(255,255,255,0.75)" }}>
+      White-label infrastructure for instant card issuance, fiat rails, and multi-currency accounts.
+    </p>
+    <a
+      href="/concepts/intro"
+      style={{
+        display: "inline-block",
+        background: "#CBFB6C",
+        color: "#1A1751",
+        fontWeight: 700,
+        padding: "14px 28px",
+        borderRadius: "999px",
+        textDecoration: "none",
+        fontSize: "16px",
+        marginTop: "28px"
+      }}
+    >
+      Start integrating today
+    </a>
+  </div>
 
-## Gnosis Pay Functionality
+</div>
 
-Gnosis Pay's first product is Gnosis Card: a stablecoin based visa debit card,
-enabling users to spend their digital assets in the traditional economy using the Gnosis Pay network.
 
-<CardGroup cols={2}>
-  <Card
-    title="⚡ Instant Spending"
-    icon="bolt"
-  >
-    Easily spend crypto like you spend cash.
-  </Card>
 
-  <Card
-    title="🌍 Global Acceptance"
-    icon="globe"
+<div style={{ maxWidth: "1100px", margin: "0 auto", padding: "56px 24px 72px" }}>
 
-  >
-    Accepted at 80+ million Visa merchants worldwide.
+<CardGroup cols={3}>
+  <Card title="Multi-Chain" icon="link">
+    Deploy Gnosis Pay infra across different blockchains. Live on Celo and Gnosis Chain.
   </Card>
-
-  <Card
-    title="🔐 Self-Custody"
-    icon="shield-check"
-    href="/gp-onchain/about-GP-safe"
-  >
-    Take control of your money through your SAFE account. You own your keys, you own your crypto.
+  <Card title="Multi-Stablecoin" icon="coins">
+    Enable your ecosystem's stablecoin as a spending currency, fully on-chain with native support.
+  </Card>
+  <Card title="KYC Sharing" icon="user-check">
+    Accept KYC already verified by trusted partners, no need of double KYC verification process.
+  </Card>
+  <Card title="Instant Reversals" icon="rotate-left">
+    Reversals are processed instantly as the message is received by network.
+  </Card>
+  <Card title="Multi-Currency Setup" icon="wallet">
+   Setup multi-currency accounts in EUR, USD, and GBP available.
   </Card>
+  <Card title="Global Reach" icon="globe">
+    Live across Brazil, the EU, UK, Cyprus, Colombia, the Philippines, Mexico, Japan, Indonesia, Thailand, and Singapore and expanding.
+  </Card>
+</CardGroup>
 
-    <Card
-    title="💰 DeFi Protocol Integration"
-    icon="coins"
-    >
-    Add savings and investment features by connecting to DeFi protocols through plug-and-play integrations.
-    </Card>
+</div>
 
-  <Card
-    title="💰 Up to 5% Cashback"
-    icon="coins"
-  >
-    Earn up to 5% cashback on eligible transactions based on the amount of GNO you hold in your wallet.
-  </Card>
+<div style={{ maxWidth: "1100px", margin: "0 auto", padding: "56px 24px 80px" }}>
 
-  <Card
-    title="🏦 On/Off Ramp Integrations"
-    icon="building-columns"
-    href="/on-off-ramps/index"
-  >
-  On and Off ramp integrations are available with our integrated ramp partners such as Noah, Monerium and Avenia.
-  </Card>
 
-</CardGroup>
+
+</div>
diff --git a/integration-model.mdx b/integration-model.mdx
deleted file mode 100644
index ff586b0..0000000
--- a/integration-model.mdx
+++ /dev/null
@@ -1,118 +0,0 @@
----
-title: "Integration models : Permissionless vs Partnerships"
-description: "Gnosis Pay offers two ways of integrating Gnosis Pay APIs. Whether you’re building as a developer or looking to launch a whitelisted branded solution, Gnosis Pay is designed to be flexible and accessible for all developers and businesses."
----
-## Integration Models: Permissionless vs Partnerships
-
-Gnosis Pay offers two ways to get started:
-
-1. Permissionless Integration
-2. Partnership Integration
-
----
-## 1. Permissionless Integration (Free Plan Only)
-
-Developers can start building with our APIs right away—no need to contact us or go through an approval process. This lets you quickly enable crypto payments, card issuance, and account features for your users.
-
-<img
-  src="static/img/API Flows_permissionless.png"
-  alt="Permissionless API Flow - Start building and testing with Gnosis Pay APIs"
-  className="rounded-lg shadow-lg"
-/>
-
-<Info>
-This integration requires no special credentials. Simply authenticate with our APIs using SIWE (Sign-In with Ethereum) to receive a JWT token and start building.
-</Info>
-
-**Who it's for:** Developers or small teams who want to explore the APIs, prototype, or run very lightweight programs.
-
-<CardGroup cols={2}>
-  <Card title="What You Can Do" icon="check" color="#16a34a">
-    - ✅ Make API calls immediately — no API keys, approvals, or contracts
-    - ✅ Issue and manage Gnosis-branded cards for testing and early users
-    - ✅ Experiment with basic functionality (card issuance, transactions, balance queries)
-  </Card>
-
-  <Card title="What You Can't Do" icon="x" color="#dc2626">
-    - ❌ Attribute card activity back to your business (no webhooks, no tracking)
-    - ❌ Display sensitive card details (requires Partner Secure Element)
-    - ❌ Launch a branded card program at scale
-  </Card>
-</CardGroup>
-
-<Card title="🚀 When to Move On" icon="arrow-right" color="#2563eb">
-Once you want to connect card activity to your app/business or expose sensitive card details, you'll need to switch into Partnership mode.
-</Card>
-
----
-
-## 2. Partnership Integration (Free, Startup, and Enterprise)
-
-If your company is interested in deeper collaboration—such as branded cards, custom user experiences, fee rebates, or co-marketing opportunities — you can sign up through our [Partners Dashboard](https://partners.gnosispay.com/).
-
-<Warning>
-**Domain Whitelisting Required**: During partner signup, you must provide all production and staging domains where your application will be hosted. These domains are whitelisted for SIWE (Sign-In with Ethereum) authentication and CORS.
-
-- **localhost**: Automatically allowed for local development (e.g., `localhost:3000`)
-- **Production/Staging**: All non-localhost domains must be registered during signup
-- Applications running on non-whitelisted domains will face authentication failures
-</Warning>
-
-
-
-<img
-  src="/static/img/API Flows_partnership.png"
-  alt="Partnership API Flow - Start building and testing with Gnosis Pay APIs"
-  className="rounded-lg shadow-lg"
-/>
-
-**Who it's for:** Any partner ready to move beyond experimentation and operate a live program.
-
-<CardGroup cols={2}>
-  <Card title="Key Credentials" icon="key" color="#7c3aed" href="/integration-model#getting-your-partnerid-and-app-id">
-    - **Partner ID** → Required for webhooks, attribution, and tracking
-
-    - **App ID** → Required for Partner Secure Element (PSE) access
-  </Card>
-
-  <Card title="Advanced Features" icon="star" color="#ea580c">
-    - Branded cards and custom experiences
-    - Multi-market support
-    - BIN sponsorship
-    - Compliance oversight
-  </Card>
-</CardGroup>
-
-<CardGroup cols={2}>
-  <Card title="Dedicated Support" icon="headset" color="#059669">
-    Direct access to Gnosis Pay team for technical guidance and business support.
-  </Card>
-
-  <Card title="Full Observability" icon="chart-bar" color="#2563eb">
-    Complete integration into your systems with webhooks and analytics.
-  </Card>
-</CardGroup>
-
-**Mandatory for:** Startup and Enterprise plans, but also available to Free Plan partners who want to extend beyond pure experimentation.
-
-
-## **Getting Your PartnerID and APP_ID**
-
-Through our self-service [Partners Dashboard](https://partners.gnosispay.com/), partners can:
-- **PartnerID**: A unique identifier for partner organization within the Gnosis Pay ecosystem, enabling us to track user acquisition and attribute activity to integration.
-
-- **APP_ID**: An application-specific identifier that allows partners to authenticate with the PSE (Partner Secure Elements) and establish secure mTLS connection authentication between partner and Gnosis Pay.
-    <img
-      src="/static/img/partner_dashboard.png"
-      alt="Partners Dashboard - Self-service partner registration and management"
-      className="rounded-lg shadow-lg"
-    />
-<Info>
-    To get your PartnerID and APP_ID through the Partners Dashboard:
-    1. Sign up at [partners.gnosispay.com](https://partners.gnosispay.com/)
-    2. Include your company details and app domains (required for CORS whitelisting)
-    3. Get your PartnerID and APP_ID instantly upon registration
-    4. Handle PSE integration setup, CSR signature, and webhook configuration directly through the dashboard
-
-    **Critical**: You must include all your production and staging domains during signup. While localhost is automatically allowed for development, all other domains must be whitelisted for both CORS and SIWE authentication. Missing domains will cause authentication failures and API access issues.
-</Info>
diff --git a/migration/migration-overview.mdx b/migration/migration-overview.mdx
new file mode 100644
index 0000000..a0fd651
--- /dev/null
+++ b/migration/migration-overview.mdx
@@ -0,0 +1,23 @@
+---
+title: "Migrating to new Gnosis Pay APIs"
+description: "Overview of the differences between Gnosis Pay's old and new infrastructure, only applicable to old Partners integrating new APIs"
+---
+
+This page compares Gnosis Pay's old API infrastructure against the current architecture, to help partners understand what changed and why, particularly around authentication, ownership, and other flows.
+
+## Feature Comparison
+
+| Feature | Old API | New API |
+|---|---|---|
+| **SIWE Authentication** | Long-lived access token (24h) | Access token (15 min validity) and refresh token model (7 days validity) with rotation support |
+| **Reversals** | Processed after 1 business day | Instantly processed right after the clearing message |
+| **KYC Verification** | Dependent on Gnosis Pay to complete KYC; Gnosis Pay shares KYC results with partners | KYC can be performed by partners and shared with Gnosis Pay |
+| **Safe Deployment** | Dedicated Safe deployment endpoint | Single `/account` endpoint handling provisioning + creation |
+| **Token Management** | Limited support for single token/currency | Multi-currency support with different balance states |
+| **Account Balances** | Spendable, non-spendable, and total balance | Detailed breakdown: spendable, authorized holds, non-spendable, processing deposits |
+| **Withdrawals** | Subject to delay module | Instant, bypassing the delay module |
+| **Daily Onchain Spending Limits** | Set by user, requires an onchain signature | Hardcoded at $20,000 daily limit (2x card limit buffer), no signature required |
+| **Delay Module Configuration** | 3-minute delay, 30-minute expiration | 25-hour delay, 31-hour expiration (discourages usage) |
+| **Transactions** | Separated by card transaction and onchain transaction; onchain transactions only available via RPC | Unified account-statement endpoint showing deposits, withdrawals, and card transactions |
+| **Owner Address** | Multiple SIWE-authenticated addresses could be added alongside the Safe owner | A single owner address, set at account creation, cannot be changed, and no other SIWE addresses can be added |
+| **Pre-Authorization Holds**| Not allowed in old infrastructure | Pre-authorization holds allowed, users can use it for gas stations or car rentals etc. |
diff --git a/on-off-ramps/iban-integration.mdx b/on-off-ramps/iban-integration.mdx
deleted file mode 100644
index 79a1ecf..0000000
--- a/on-off-ramps/iban-integration.mdx
+++ /dev/null
@@ -1,151 +0,0 @@
----
-title: IBAN Integration
-description: IBAN cash-in to the Gnosis Pay Account via Monerium
----
-
-We offer IBAN cash-in to the Gnosis Pay Account via Monerium for users in Europe (EU) and Switzerland.
-
-Monerium's IBAN integration enables direct connection between the owner of the GP Safe (which is the authenticated account address for SIWE) and Monerium.
-
-- By calling the integrations endpoint (see below), it shares the user's KYC with Monerium.
-
-- You can use [Monerium API](https://monerium.dev/api-docs/v2) to authenticate with SIWE and perform actions enabled by the Monerium API
-
-- This API operates independently of the GP Safe and does not involve signatures on the delay module.
-
-
-
-## Check Availability
-
-[First you need to check if the user is eligible to have an IBAN](/api-reference/iban/check-iban-availability):
-
-```bash cURL
-curl -X GET /api/v1/ibans/available
-```
-
-If you receive a `"available": false`, the flow ends here.
-
-<Warning>
-Requirements that the Gnosis Pay user must have:
-- Valid date of birth
-- An active EURe Safe Account
-- KYC verified and approved
-- Residency in a supported country
-- First and last name defined (or name)
-- Valid location fields filled in (address1, postalCode, city and country, none of these fields can be missing)
-- Nationality from a supported country ([see allowed and restricted nationalities](https://help.gnosispay.com/hc/en-us/articles/39558629298708-Eligible-Nationalities-for-the-Gnosis-Pay-IBAN-Feature))
-</Warning>
-
-## Enabling the IBAN Integration
-
-
-<Steps titleSize="h3">
-<Step title="Signing the Monerium message">
-
-Monerium requires a specific message to be signed by the user's wallet to prove the ownership of the wallet.
-[Use this endpoint to get the exact message that needs to be signed](/api-reference/iban/get-the-message-that-needs-to-be-signed-for-iban-activation):
-
-```bash cURL
-curl -X GET /api/v1/ibans/signing-message
-```
-
-<Warning>
-We cannot request new IBANs nor transfer existing IBANs until the message signature is completed. This signature is a mandatory requirement from Monerium to verify ownership of the address.
-</Warning>
-
-</Step>
-
-<Step title="Sign the Message with the User's Wallet">
-
-Use the message string returned from [step 1](#signing-the-monerium-message) to generate a signature with the user's wallet.
-
-To request signature from the user's wallet, you can follow this [demo signature implementation](#message-signing-example-with-viem).
-
-</Step>
-
-<Step title="Request the IBAN from Monerium">
-
-[Make a POST request to this endpoint to request IBAN integration for Gnosis Pay user](https://docs.gnosispay.com/api-reference/iban/create-a-new-monerium-integration):
-
-```bash cURL
-curl --request POST \
-  --url https://api.gnosispay.com/api/v1/integrations/monerium \
-  --header 'Authorization: Bearer <token>' \
-  --header 'Content-Type: application/json' \
-  --data '{
-  "signature": "<string>"
-}'
-```
-If the request is successful, you will receive a response with the IBAN details.
-This endpoint effectively:
-- shares the user's KYC info with Monerium
-- creates an IBAN linked to the user's account
-
-<Warning>
-Monerium only allows the user to have one single account with them. If a Monerium account **already exists**, then there is **no need** to call this endpoint. In such cases, users can grant access to their existing Monerium account using the Monerium API directly.
-</Warning>
-
-</Step>
-
-<Step title="Get the IBAN number, BIC, Status and Connected Blockchain Address where funds are sent">
-
-To retrieve IBAN details including the IBAN number, BIC code, status, and connected account address, you can get them with the `bankingDetails` field from:
-```bash cURL
-curl -X GET /api/v1/user
-```
-
-</Step>
-
-<Step title="Using the Monerium API">
-
-Follow the guide available at https://monerium.dev/docs/welcome
-To authenticate with their API, you can then use the method described in https://monerium.dev/api-docs/v2#tag/auth *using the SIWE* flow.
-
-Once authenticated, you can manage IBANs, create instructions to transfer funds from one account to another, etc.
-
-</Step>
-</Steps>
-
-<Warning>
-For detailed error status codes and examples, please refer to the API Reference documentation [here for IBAN integration](https://docs.gnosispay.com/api-reference/iban/create-a-new-monerium-integration).
-
-The Gnosis Pay API serves as a wrapper for Monerium IBAN integration. Therefore, any issues related to Monerium integration should be addressed directly between your products and Monerium.
-</Warning>
-
-## Message Signing Example with Viem
-
-This is an example script to generate a signature from an EOA wallet address that is an owner of GP Safe and will be linked to Monerium profile.
-
-### Example Usage
-
-```typescript
-import { createWalletClient, http } from 'viem';
-import { gnosis } from 'viem/chains';
-import { privateKeyToAccount } from 'viem/accounts';
-
-// Initialize wallet client with private key
-const account = privateKeyToAccount('0x...' as `0x${string}`);
-const walletClient = createWalletClient({
-  account,
-  chain: gnosis,
-  transport: http()
-});
-
-// Get the message to sign from the API
-const message = "I hereby declare that I am the address owner.";
-
-// Sign the message directly with EOA
-const signature = await walletClient.signMessage({
-  message
-});
-
-console.log('Signature:', signature);
-console.log('Signer address:', account.address);
-```
-
-<Info>
-Note:
-- The message can be fetched from the API using `GET /api/v1/ibans/signing-message`
-- The signature can be submitted to prove ownership
-- Make sure to use the correct chainId (100 for Gnosis Chain)
-</Info>
diff --git a/on-off-ramps/index.mdx b/on-off-ramps/index.mdx
deleted file mode 100644
index b346453..0000000
--- a/on-off-ramps/index.mdx
+++ /dev/null
@@ -1,61 +0,0 @@
----
-title: "On/Off Ramp Integrations"
-description: "Complete guide to fiat-to-crypto conversions with Gnosis Pay's integrated ramp partners"
----
-
-# On/Off Ramp Integrations
-
-Convert between fiat currencies and stablecoins seamlessly with Gnosis Pay's integrated ramp partners.
-
-<Warning>
-**No Double KYC Required**
-
-On/Off ramp integrations don't require users to complete another KYC process with Gnosis Pay - they can use their existing verification from our integrated partners.
-</Warning>
-
-<Info>
-**Important Partnership Requirements**
-
-Please be aware of the following integration requirements:
-
--**Direct Provider Relationships**: The wallet/platform must establish a direct contractual relationship with the ramp provider (e.g., Noah, Monerium, Avenia) and integrate directly with their APIs. Gnosis Pay will only facilitate the KYC process by sharing the KYC collected data via Sumsub.
-
-- **Mandatory usage of Sumsub**: It is mandatory to use Sumsub instance to avail these integrations.
-
-
-For detailed KYC sharing implementation, please refer to our [KYC Sharing Integration Guide](on-off-ramps/kyc-sharing).
-</Info>
-
-## Available Integrations
-
-<CardGroup cols={3}>
-  <Card
-    title="💶 EUR Integration"
-    icon="euro-sign"
-    href="on-off-ramps/iban-integration"
-  >
-    **EUR to EUR.e via Monerium**
-
-    Full SEPA integration with IBAN support for European users.
-  </Card>
-
-  <Card
-    title="💵 USD Integration"
-    icon="dollar-sign"
-    href="https://docs.noah.com/"
-  >
-    **USD to USDC.e via Noah**
-
-    Fast and reliable USD conversion for North American markets.
-  </Card>
-
-  <Card
-    title="🇧🇷 BRL Integration"
-    icon="brazilian-real-sign"
-    href="https://integration-guide.avenia.io/"
-  >
-    **BRL to BRLA via Avenia**
-
-    Brazilian Real support specifically designed for LatAm markets.
-  </Card>
-</CardGroup>
diff --git a/on-off-ramps/kyc-sharing.mdx b/on-off-ramps/kyc-sharing.mdx
deleted file mode 100644
index bc974df..0000000
--- a/on-off-ramps/kyc-sharing.mdx
+++ /dev/null
@@ -1,57 +0,0 @@
----
-title: KYC sharing for GP Partners
-description: This guide explains how to share existing Gnosis Pay KYC data with GP Partners using Sumsub's reusable token system.
----
-## KYC Sharing Partners
-
-KYC Sharing allows users who have already completed verification with Gnosis Pay to re-use their KYC data with partner platforms, eliminating the need for duplicate verification processes. KYC sharing is currently only available through **Sumsub** and requires a formal contract between three parties: Gnosis Pay, Sumsub, and partner platform.
-
-<Warning>
-**Important Limitations**
-
-- **One-Way Sharing**: We only support **Gnosis Pay → Partner Platform** sharing. KYC data cannot be shared from partner platforms back to Gnosis Pay.
-- **Approval Not Guaranteed**: Since every company has different KYC requirements and risk policies, some Gnosis Pay approved KYCs may be rejected at the destination platform.
-</Warning>
-
-## How to get reusable token for KYC Sharing Partners
-
-The following partners currently support KYC data sharing:
-
-| Partner | Sumsub Client ID |
-|---------|------------------|
-| Noah | `noah.com_112876` |
-| BRLA | `brla.digital_101963` |
-
-<Steps titleSize="h3">
-    <Step title="Get Partner's Sumsub Client ID">
-        For existing partners available for KYC sharing, use one of the Client IDs from the table above. For partners not listed in the table, contact the Partner team to obtain their SumSub Client ID.
-    </Step>
-
-<Step title="Share KYC Data">
-    <p>
-      Once the Sumsub Client ID has been obtained, generate a reusable token using the Gnosis Pay API.
-    </p>
-
-      ```bash cURL
-      curl --request POST \
-        --url https://api.gnosispay.com/api/v1/kyc/import-partner-applicant \
-        --header 'Authorization: Bearer <token>' \
-        --header 'Content-Type: application/json' \
-        --data '{
-        "forClientId": "noah.com_112876",
-        "ttlInSecs": 600
-      }'
-      ```
-</Step>
-
-<Step title="Get applicant data from Sumsub">
-    <p>
-    Share this token to Sumsub's API to re-use the KYC and get data for users. To learn more about how to use Sumsub's API, visit their documentation [here](https://docs.sumsub.com/docs/reusable-kyc).
-    </p>
-
-      ```bash cURL
-      curl --request POST \
-           --url https://api.sumsub.com/resources/api/reusableIdentity/reuse
-      ```
-</Step>
-</Steps>
diff --git a/onboarding-flow.mdx b/onboarding-flow.mdx
deleted file mode 100644
index b8d4c65..0000000
--- a/onboarding-flow.mdx
+++ /dev/null
@@ -1,272 +0,0 @@
----
-title: Onboard Users to Gnosis Pay
-description: How to onboard new Users to Gnosis Pay.
----
-
-Welcome! This guide will walk you through the journey to implement the complete onboarding of a user, from the first time they connect their wallet, to the point where they can order a card (physical or virtual) and start using it.
-
-If you want to see how it all comes together, check out our open-source [Gnosis Pay UI](https://github.com/gnosispay/ui) for a reference implementation.
-
-Let's jump right in!
-
-## 1. Authentication
-
-First things first: your users need to authenticate with our API.
-This is covered in detail in the [Authentication Flow](/auth) section.
-Once they're authenticated, you'll get a `jwt`, you'll need it for all the next steps.
-
-## 2. User Registration
-
-Now that you've got your `jwt` token, it's time to register your user in the Gnosis Pay system.
-
-<Note>
-There are 2 ways to know whether they are already registered or not:
-
-- **Check the JWT:** If the decoded JWT has a `userId`, your user is already registered.
-- **Or, call the user endpoint:** Try [`GET /api/v1/user`](/api-reference/user/get-the-user-profile). If you get a `401 Unauthorized Error`, the user isn't registered yet.
-</Note>
-
-<Steps titleSize="h3">
-<Step title="Signup with email">
-You can register a user with their `email` and `partnerId`, [see api documentation](/api-reference/authentication/create-a-new-user).
-
-<Note>
-The `partnerId` is a unique identifier for your app that you can get instantly from the [Partners Dashboard](https://partners.gnosispay.com/). This is the only place where you need to include it in the request.
-</Note>
-
-If you have a `referralCouponCode`, you can include it here too.
-
-```bash cURL
-curl -X POST /api/v1/auth/signup \
--d '{
-  "authEmail": "string",
-  "partnerId": "string",
-  "referralCouponCode": "string" (optional)
-}'
-```
-
-</Step>
-<Step title="Accept Terms of Service (ToS)">
-At this point, the user is registered in the Gnosis Pay system and has an associated user id.
-Users need to accept our terms of service and those from our partners. To streamline the process, you can do this step together with the previous one.
-
-We recommend having a mapping in your app, between the ToS id and their title and urls, so you can display the title and link out for users to read the full text. Make sure they check a box to accept before moving on!
-
-<Info>
-This endpoint can only be called once the user is registered. Hence the proposed mapping.
-</Info>
-
-Get the terms for the user [(spec)](/api-reference/user/retrieve-terms-and-conditions-status):
-```bash cURL
-curl -X GET /api/v1/user/terms
-```
-We recommend you link each ID received on this endpoint with a title in your app:
-
-```javascript
-const tosToTitle = {
-  "general-tos": "Gnosis Pay Terms of Service",
-  "card-monavate-tos": "Cardholder Terms of Service",
-  "cashback-tos": "Cashback Terms of Service",
-  "privacy-policy": "Gnosis Pay Privacy and Cookies Policy"
-}
-```
-
-Once the user has reviewed and accepted the ToS, you can call the endpoint to accept each ToS that the user hadn't accepted yet [(spec)](/api-reference/user/accept-terms-and-conditions):
-```bash cURL
-curl -X POST /api/v1/user/terms \
--d '{
-  "terms": "string", // e.g. "general-tos"
-  "version": "string" // e.g. "TOS_GENERAL_VERSION_1"
-}'
-```
-
-</Step>
-</Steps>
-
-## 3. KYC Process
-
-To order a card, your users will need to go through a KYC process with our partner Sumsub. The whole KYC flow happens in a Sumsub iframe, and in the background, the Gnosis Pay API keeps you updated on your user's `kycStatus` (check it with [`GET /api/v1/user`](/api-reference/user/retrieve-user-profile)
-
-Here are the different KYC statuses you might see, and what they mean for your user:
-
-| **KYC Status**                | **Description**                                                                                                          | **What your user should do**              |
-| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------- |
-| `notStarted`                  | No KYC process started                                                                                                   | Start KYC                                 |
-| `documentsRequested`          | Applicant must upload documents. Status moves to `pending` when done.                                                    | Upload documents                          |
-| `pending`                     | Awaiting verification processing                                                                                         | Nothing—just wait!                        |
-| `processing`                  | Profile is being processed                                                                                               | Nothing—system is checking                |
-| `approved`                    | All verification checks passed                                                                                           | Nothing—KYC is complete                   |
-| `resubmissionRequested`       | Some checks failed; user can re-submit required steps                                                                    | Re-submit documents                       |
-| `rejected`                    | Final rejection; user cannot try again                                                                                   | Nothing (final rejection)                 |
-| `requiresAction`              | Manual check required by our team                                                                                        | Wait or contact support                   |
-
-<Note>
-You should start the KYC process if your user is registered and their `kycStatus` is `notStarted` or `documentsRequested`.
-</Note>
-
-<Steps titleSize="h3">
-<Step title="Get the Sumsub iframe URL or SDK token">
-By default, each user gets a unique URL for their KYC process.
-Get it with [(spec)](/api-reference/kyc/retrieve-link-for-web-integration):
-
-```bash cURL
-curl -X GET /api/v1/kyc/integration
-```
-
-For mobile integrations, you can use the Sumsub Mobile SDK.
-To instantiate their SDK you need an access token that you can get from [(spec)](/api-reference/kyc/retrieve-access-token-for-sumsub-sdk-integration):
-
-```bash cURL
-curl -X GET /api/v1/kyc/integration/sdk
-```
-
-</Step>
-<Step title="Monitor KYC Status">
-
-While the whole KYC flow happens in an iframe, it is advised to constantly monitor the `kycStatus` from the user endpoint, and act if users are in certain states.
-
-Provide a way to contact your support if the `kycStatus` is:
-- `requiresAction`
-- `rejected`
-
-If the status is one of the following, there's nothing to do on your side:
-  - `pending`
-  - `processing`
-  - `resubmissionRequested`
-
-Finally, if the status is `approved`, you can move on to the next step.
-
-</Step>
-<Step title="Source of funds questionnaire">
-
-For regulatory reasons, users need to answer a couple of questions regarding the source of funds for their card.
-
-<Note>
-Users should be ready for this step if:
-- they are registered (a `userId` is present in the JWT)
-- their `kycStatus` is `approved`
-- the field `isSourceOfFundsAnswered` on the user endpoint response is `false`
-</Note>
-
-You can get the list of questions and possible answers at this endpoint [(spec)](/api-reference/kyc/retrieve-source-of-funds-questions):
-
-```bash cURL
-curl -X GET /api/v1/source-of-funds
-```
-
-Show these questions to your user and collect their answers. You'll need to send all the answers together in one go [(spec)](/api-reference/kyc/answer-source-of-funds-questions):
-
-```bash cURL
-curl -X POST /api/v1/source-of-funds \
--d '[
-  {
-    question: "string",
-    answer: "string"
-  },
-  ...
-]'
-```
-
-Don't forget to include the question title with each answer. If you want to see how this looks in practice, check out [Gnosis Pay UI](https://github.com/gnosispay/ui).
-
-</Step>
-<Step title="Phone Verification with OTP">
-
-Last but not least, your users need to verify their mobile phone. Just like with email, they'll enter their phone number, get a one-time password (OTP), and we'll verify it.
-
-<Note>
-This step is needed if:
-- The user is registered (`userId` in JWT)
-- `kycStatus` is `approved`
-- `isPhoneValidated` is `false` in the user endpoint response
-</Note>
-
-Validate the phone number by first requesting an OTP [(spec)](/api-reference/kyc/retrieve-an-otp-code-to-verify-a-phone-number):
-
-```bash cURL
-curl -X POST /api/v1/verification \
--d '{
-  "phoneNumber": "string"
-}'
-```
-
-This will send a code to the user's phone number, which in turn needs to be passed on to the check endpoint [(spec)](/api-reference/kyc/verify-a-phone-number-with-otp-code):
-
-```bash cURL
-curl -X POST /api/v1/verification/check \
--d '{
-  "code": "string"
-}'
-```
-
-Once that's done, `isPhoneValidated` will be `true`.
-</Step>
-</Steps>
-
-
-<Note>
-User's safe is ready for configuration if:
-- They are registered (`userId` in JWT)
-- `kycStatus` is `approved`
-- `isSourceOfFundsAnswered` is `true`
-- `isPhoneValidated` is `true`
-- `safeWallet` is an empty array in the user endpoint response
-</Note>
-
-## 4. Safe Account Configuration
-
-Gnosis Pay uses Safe accounts for on-chain transactions. This endpoint deploys GP Safe with currency and setup delay and roles modules for the GP Safe.
-
-The currency is automatically assigned based on the user's country:
-
-- UK users (GB): GBPe
-- Brazil users (BR): USDCe
-- Users from other countries: EURe (default)
-
-<Note>
-Before this, note that the field `accountStatus` is a number that is not `0` in the response from [`GET /api/v1/safe-config`](/api-reference/safe-management/retrieve-safe-configuration).
-`accountStatus: 0` would mean that the Safe modules are already deployed.
-</Note>
-
-
-```bash cURL
-curl --request POST \
-  --url https://api.gnosispay.com/api/v1/safe/deploy \
-  --header 'Authorization: Bearer <token>'
-```
-<Note>
-  If safe deployment request is successful, it will return as "accepted" from endpoint. From here it can take up to 1 minute for safe deployment and module setup.
-</Note>
-
-## 5. Monitor Safe Deployment Status
-
-After initiating the GP Safe deployment, monitor the deployment progress using the [v1/safe/deploy](https://docs.gnosispay.com/api-reference/safe-management/get-the-safe-deployment-status) endpoint:
-
-```bash cURL
-curl --request GET \
-  --url https://api.gnosispay.com/api/v1/safe/deploy \
-  --header 'Authorization: Bearer <token>'
-```
-
-### Verify safe configuration post deployment
-
-Once deployment is complete, verify the Safe is fully configured by checking the account status:
-
-```bash cURL
-curl --request GET \
-  --url https://api.gnosispay.com/api/v1/safe-config \
-  --header 'Authorization: Bearer <token>'
-```
-
-<Note>
-When `accountStatus` is **0**, the GP Safe is fully configured and ready for use.
-</Note>
-
-### Using Account-Kit for Integrity Status
-
- Gnosis Pay Account-Kit library [`@gnosispay/account-kit`](https://github.com/gnosispay/account-kit) can provide a handy `AccountIntegrityStatus` enum.
-
-- `AccountIntegrityStatus.Ok`, which is `0`, means that the Safe modules are already deployed.
-- `AccountIntegrityStatus.DelayQueueNotEmpty`, which is `7`, means the module is deployed correctly, but the Safe has a pending transaction, which could happen later on.
-
- If your interface is verifying the Safe modules deployment, both these statuses should be considered as valid.
diff --git a/static/css/custom.css b/static/css/custom.css
new file mode 100644
index 0000000..82143c7
--- /dev/null
+++ b/static/css/custom.css
@@ -0,0 +1,120 @@
+/* Gnosis Pay brand palette — using Mintlify's documented CSS hooks */
+
+/* Hero headline — explicit color per theme, don't rely on inherited default */
+.hero-title {
+    color: #000000;
+}
+html.dark .hero-title {
+    color: #ffffff;
+}
+
+/* Hero subtext — real color per theme instead of flat opacity (which read as washed-out grey) */
+.hero-subtext {
+    color: #4a4570;
+}
+html.dark .hero-subtext {
+    color: #c6c2ee;
+}
+
+/* Page background */
+#background-color {
+    background-color: #fbebd4 !important;
+}
+html.dark #background-color {
+    background-color: #0b0836 !important;
+}
+
+/* Top navbar */
+#navbar {
+    background-color: #1a1751 !important;
+}
+
+/* Nav links — neon highlight on hover */
+navbar-link:hover,
+nav-anchor:hover {
+    color: #cbfb6c !important;
+    transition: color 0.15s ease;
+}
+
+/* CTA button in the topbar ("Sign up as Partner") */
+#topbar-cta-button {
+    background-color: #cbfb6c !important;
+    color: #1a1751 !important;
+    border: none !important;
+    border-radius: 999px !important;
+    transition:
+        filter 0.15s ease,
+        transform 0.15s ease;
+}
+#topbar-cta-button:hover {
+    filter: brightness(1.08);
+    transform: translateY(-1px);
+}
+
+/* Cards — neon lime border, subtle tint, glow + lift on hover */
+/* Scoped to the individual card element/class only — NOT card-group/columns wrappers */
+card,
+.card {
+    background-color: rgba(118, 109, 229, 0.05) !important;
+    border: 1px solid rgba(203, 251, 108, 0.45) !important;
+    border-radius: 12px !important;
+    box-shadow: none !important;
+    transition:
+        border-color 0.2s ease,
+        box-shadow 0.2s ease,
+        transform 0.2s ease;
+}
+card:hover,
+.card:hover {
+    border-color: #cbfb6c !important;
+    box-shadow: 0 0 0 3px rgba(203, 251, 108, 0.15) !important;
+    transform: translateY(-2px);
+}
+
+/* Explicitly strip any border/background from the group wrapper itself */
+card-group,
+columns,
+.card-group {
+    border: none !important;
+    background: none !important;
+    box-shadow: none !important;
+    gap: 24px !important;
+}
+
+/* Cards — dark mode: lighter indigo card, same neon border treatment */
+html.dark card,
+html.dark .card {
+    background-color: rgba(255, 255, 255, 0.035) !important;
+    color: #fbebd4 !important;
+}
+
+/* Footer (renders on pages without mode: custom) */
+footer {
+    background-color: transparent !important;
+    border-top: 1px solid rgba(203, 251, 108, 0.15);
+}
+/* Muted footer text/icons so they recede rather than compete with content */
+footer,
+footer a {
+    color: #4a4570 !important;
+}
+html.dark footer,
+html.dark footer a {
+    color: #c6c2ee !important;
+}
+footer a:hover {
+    color: #cbfb6c !important;
+    transition: color 0.15s ease;
+}
+
+/* Body text — stronger contrast than Mintlify's default muted grey */
+.prose,
+.prose p,
+.prose li {
+    color: #2a2550 !important; /* deep indigo-ink on the cream background */
+}
+html.dark .prose,
+html.dark .prose p,
+html.dark .prose li {
+    color: #ece9ff !important; /* near-white with a faint lilac tint */
+}
diff --git a/static/img/gnosis-pay-architecture.svg b/static/img/gnosis-pay-architecture.svg
new file mode 100644
index 0000000..b924a52
--- /dev/null
+++ b/static/img/gnosis-pay-architecture.svg
@@ -0,0 +1,114 @@
+<svg viewBox="0 0 1180 612" xmlns="http://www.w3.org/2000/svg" font-family="ui-sans-serif, system-ui, -apple-system, sans-serif">
+  <defs>
+    <linearGradient id="panel" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0" stop-color="#0a0730"/>
+      <stop offset="1" stop-color="#14114a"/>
+    </linearGradient>
+    <linearGradient id="hub" x1="0" y1="0" x2="1" y2="0">
+      <stop offset="0" stop-color="#241f74"/>
+      <stop offset="1" stop-color="#1a1660"/>
+    </linearGradient>
+  </defs>
+
+  <rect x="0" y="0" width="1180" height="612" rx="20" fill="url(#panel)"/>
+
+  <!-- section captions -->
+  <text x="475" y="42" text-anchor="middle" fill="#cbfb6c" font-size="13" font-weight="700" letter-spacing="2">PARTNER INTEGRATION</text>
+  <text x="590" y="590" text-anchor="middle" fill="#cbfb6c" font-size="13" font-weight="700" letter-spacing="2">COMPLIANCE · CUSTODY · PAYMENT PROCESSING &amp; RAILS</text>
+
+  <!-- ===== TOP: Sumsub + Partner ===== -->
+  <rect x="110" y="112" width="160" height="80" rx="12" fill="#1d1a57" stroke="rgba(203,251,108,0.35)"/>
+  <text x="190" y="148" text-anchor="middle" fill="#fbebd4" font-size="13" font-weight="600">Sumsub</text>
+  <text x="190" y="168" text-anchor="middle" fill="#a9a4e0" font-size="10">KYC &amp; identity</text>
+
+  <!-- Sumsub -> Partner integration connector -->
+  <line x1="270" y1="152" x2="300" y2="152" stroke="rgba(203,251,108,0.55)" stroke-width="1.5"/>
+  <circle cx="270" cy="152" r="3.5" fill="#cbfb6c"/>
+  <circle cx="300" cy="152" r="3.5" fill="#cbfb6c"/>
+  <text x="285" y="144" text-anchor="middle" fill="#a9a4e0" font-size="9.5">KYC</text>
+
+  <rect x="300" y="66" width="580" height="134" rx="14" fill="#1d1a57" stroke="rgba(203,251,108,0.35)"/>
+  <text x="590" y="96" text-anchor="middle" fill="#fbebd4" font-size="15" font-weight="700" letter-spacing="2">PARTNER</text>
+  <text x="590" y="114" text-anchor="middle" fill="#cbfb6c" font-size="10.5">one partner · one API token</text>
+
+  <rect x="312" y="126" width="128" height="52" rx="10" fill="#14114a" stroke="rgba(203,251,108,0.3)"/>
+  <text x="376" y="148" text-anchor="middle" fill="#fbebd4" font-size="11" font-weight="600">Onboarding API</text>
+  <text x="376" y="165" text-anchor="middle" fill="#a9a4e0" font-size="9">SIWE · KYC · TOS</text>
+
+  <rect x="454" y="126" width="128" height="52" rx="10" fill="#14114a" stroke="rgba(203,251,108,0.3)"/>
+  <text x="518" y="148" text-anchor="middle" fill="#fbebd4" font-size="11" font-weight="600">Webhooks</text>
+  <text x="518" y="165" text-anchor="middle" fill="#a9a4e0" font-size="9">real-time events</text>
+
+  <rect x="596" y="126" width="128" height="52" rx="10" fill="#14114a" stroke="rgba(203,251,108,0.3)"/>
+  <text x="660" y="148" text-anchor="middle" fill="#fbebd4" font-size="11" font-weight="600">Dashboard</text>
+  <text x="660" y="165" text-anchor="middle" fill="#a9a4e0" font-size="9">B2C support</text>
+
+  <rect x="738" y="126" width="128" height="52" rx="10" fill="#14114a" stroke="rgba(203,251,108,0.3)"/>
+  <text x="802" y="148" text-anchor="middle" fill="#fbebd4" font-size="11" font-weight="600">PSE</text>
+  <text x="802" y="165" text-anchor="middle" fill="#a9a4e0" font-size="9">Sensitive card details</text>
+
+  <!-- one-token connector -->
+  <line x1="590" y1="200" x2="590" y2="270" stroke="#cbfb6c" stroke-width="2.5"/>
+  <circle cx="590" cy="200" r="4" fill="#cbfb6c"/>
+  <circle cx="590" cy="270" r="4" fill="#cbfb6c"/>
+  <rect x="512" y="223" width="156" height="24" rx="12" fill="#0a0730" stroke="#cbfb6c"/>
+  <text x="590" y="239" text-anchor="middle" fill="#cbfb6c" font-size="10" font-weight="600">one partner = one token</text>
+
+  <!-- ===== CENTER hub: Gnosis Pay ===== -->
+  <rect x="70" y="270" width="1040" height="120" rx="16" fill="url(#hub)" stroke="#cbfb6c" stroke-width="2"/>
+  <text x="590" y="308" text-anchor="middle" fill="#fbebd4" font-size="23" font-weight="700" letter-spacing="1">GNOSIS PAY</text>
+  <text x="590" y="328" text-anchor="middle" fill="#cbfb6c" font-size="11" letter-spacing="1">API orchestration layer</text>
+
+  <rect x="320" y="348" width="140" height="30" rx="15" fill="#14114a" stroke="rgba(203,251,108,0.3)"/>
+  <text x="390" y="368" text-anchor="middle" fill="#d9d5f5" font-size="11.5" font-weight="600">Account</text>
+  <rect x="480" y="348" width="140" height="30" rx="15" fill="#14114a" stroke="rgba(203,251,108,0.3)"/>
+  <text x="550" y="368" text-anchor="middle" fill="#d9d5f5" font-size="11.5" font-weight="600">Card</text>
+  <rect x="640" y="348" width="220" height="30" rx="15" fill="#14114a" stroke="rgba(203,251,108,0.3)"/>
+  <text x="750" y="368" text-anchor="middle" fill="#d9d5f5" font-size="11.5" font-weight="600">Processing + Settlement</text>
+
+  <!-- ===== BOTTOM external systems (5) ===== -->
+  <rect x="105" y="470" width="170" height="90" rx="12" fill="#1d1a57" stroke="rgba(203,251,108,0.35)"/>
+  <text x="190" y="510" text-anchor="middle" fill="#fbebd4" font-size="13" font-weight="600">KYT</text>
+  <text x="190" y="532" text-anchor="middle" fill="#a9a4e0" font-size="10">AML on deposit</text>
+
+  <rect x="305" y="470" width="170" height="90" rx="12" fill="#211d6b" stroke="#cbfb6c" stroke-width="1.5"/>
+  <text x="390" y="510" text-anchor="middle" fill="#fbebd4" font-size="13" font-weight="600">Spending Safe</text>
+  <text x="390" y="532" text-anchor="middle" fill="#cbfb6c" font-size="10">self-custody · funds</text>
+
+  <rect x="505" y="470" width="170" height="90" rx="12" fill="#1d1a57" stroke="rgba(203,251,108,0.35)"/>
+  <text x="590" y="510" text-anchor="middle" fill="#fbebd4" font-size="13" font-weight="600">Pismo</text>
+  <text x="590" y="532" text-anchor="middle" fill="#a9a4e0" font-size="10">payment processor</text>
+
+  <rect x="705" y="470" width="170" height="90" rx="12" fill="#1d1a57" stroke="#f0b34a" stroke-width="1.5" stroke-dasharray="6 4"/>
+  <text x="790" y="510" text-anchor="middle" fill="#fbebd4" font-size="13" font-weight="600">Monavate</text>
+  <text x="790" y="532" text-anchor="middle" fill="#f0b34a" font-size="10">settlement · 12h</text>
+
+  <rect x="905" y="470" width="170" height="90" rx="12" fill="#1d1a57" stroke="rgba(203,251,108,0.35)"/>
+  <text x="990" y="510" text-anchor="middle" fill="#fbebd4" font-size="13" font-weight="600">Visa</text>
+  <text x="990" y="532" text-anchor="middle" fill="#a9a4e0" font-size="10">card network</text>
+
+  <!-- KYT screens deposits into Safe -->
+  <line x1="275" y1="515" x2="305" y2="515" stroke="#cbfb6c" stroke-width="1.4" stroke-dasharray="4 3"/>
+
+  <!-- connectors hub -> bottom -->
+  <line x1="190" y1="390" x2="190" y2="470" stroke="rgba(203,251,108,0.55)" stroke-width="1.5"/>
+  <circle cx="190" cy="390" r="3.5" fill="#cbfb6c"/>
+  <text x="198" y="434" fill="#a9a4e0" font-size="9.5">AML screening</text>
+
+  <line x1="390" y1="390" x2="390" y2="470" stroke="rgba(203,251,108,0.55)" stroke-width="1.5"/>
+  <circle cx="390" cy="390" r="3.5" fill="#cbfb6c"/>
+  <text x="398" y="434" fill="#a9a4e0" font-size="9.5">custody</text>
+
+  <line x1="590" y1="390" x2="590" y2="470" stroke="rgba(203,251,108,0.55)" stroke-width="1.5"/>
+  <circle cx="590" cy="390" r="3.5" fill="#cbfb6c"/>
+  <text x="598" y="434" fill="#a9a4e0" font-size="9.5">processing</text>
+
+  <line x1="790" y1="390" x2="790" y2="470" stroke="rgba(240,179,74,0.6)" stroke-width="1.5" stroke-dasharray="5 4"/>
+  <circle cx="790" cy="390" r="3.5" fill="#f0b34a"/>
+  <text x="798" y="434" fill="#f0b34a" font-size="9.5">12h settlement</text>
+
+  <line x1="990" y1="390" x2="990" y2="470" stroke="rgba(203,251,108,0.55)" stroke-width="1.5"/>
+  <circle cx="990" cy="390" r="3.5" fill="#cbfb6c"/>
+  <text x="998" y="434" fill="#a9a4e0" font-size="9.5">card rail</text>
+
+</svg>
diff --git a/static/img/hero-visual.png b/static/img/hero-visual.png
new file mode 100644
index 0000000..2b78c6c
Binary files /dev/null and b/static/img/hero-visual.png differ
diff --git a/static/img/logo-dark.svg b/static/img/logo-dark.svg
new file mode 100644
index 0000000..06ba878
--- /dev/null
+++ b/static/img/logo-dark.svg
@@ -0,0 +1,12 @@
+<svg width="175" height="31" viewBox="0 0 175 31" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M13.6713 13.665V18.4176H22.436C21.3448 21.729 18.4236 24.3781 14.0225 24.3781C9.11461 24.3781 5.64905 20.4434 5.64905 15.4963C5.64905 10.5493 9.27015 6.61451 14.3336 6.61451C16.6443 6.61451 18.5733 7.39345 20.0133 8.66615C20.6001 9.20352 21.4037 10.1321 21.6959 11.3836H27.365C27.365 11.3836 27.4016 9.91765 26.4483 8.05455C26.4483 8.05455 26.4471 8.05219 26.4459 8.05101C25.8815 6.95036 24.9706 5.71065 23.5012 4.55344C23.4918 4.54637 23.4823 4.5393 23.4729 4.53223C21.0537 2.52772 17.8463 1.354 14.0602 1.354C5.95778 1.35518 0 7.51012 0 15.4963C0 23.4825 5.95778 29.6375 14.0213 29.6375C22.0848 29.6375 28.0838 23.6381 28.0838 15.8475V13.6662H13.6713V13.665Z" fill="#1A1751"/>
+<path d="M96.1445 29.4038V1.58813H101.637V29.4026H96.1445V29.4038Z" fill="#1A1751"/>
+<path d="M73.4564 13.6167C73.4564 12.6787 73.1477 11.8267 72.6139 11.1503L66.966 16.7961C67.6542 17.33 68.5073 17.6387 69.4335 17.6387C71.6641 17.6375 73.4682 15.8357 73.4564 13.6167ZM56.6566 17.6246C54.4377 17.6364 52.6336 15.8334 52.6336 13.6026C52.6336 12.6775 52.9424 11.8244 53.4762 11.1362L59.124 16.782C58.4477 17.3158 57.5945 17.6246 56.6566 17.6246ZM52.2907 9.97422C51.46 10.9712 50.9616 12.2274 50.9616 13.6273C50.9616 16.7702 53.5127 19.3203 56.6566 19.3203C58.0447 19.3203 59.3138 18.8219 60.3107 17.9911L63.0515 20.7309L65.7924 17.9911C66.7893 18.8219 68.0466 19.3203 69.4465 19.3203C72.5903 19.3203 75.1415 16.7702 75.1415 13.6273C75.1415 12.2403 74.643 10.97 73.8135 9.97422L76.3163 7.47242C77.7409 9.81985 78.5587 12.5597 78.5587 15.5022C78.5587 24.0659 71.6182 30.9927 63.0633 30.9927C54.5084 30.9927 47.5679 24.0541 47.5679 15.5022C47.5443 12.5491 48.3633 9.80924 49.7867 7.47242L52.2896 9.97422H52.2907ZM63.0633 18.3599L75.3559 6.07244C75.0119 5.63289 74.6454 5.2063 74.2636 4.80445C71.4403 1.85013 67.4656 0 63.0515 0C58.6374 0 54.6522 1.85013 51.8394 4.80328C51.4482 5.19451 51.0794 5.63407 50.7707 6.05948L63.0633 18.3587V18.3599ZM72.5797 5.96639L63.0527 15.4904L53.5257 5.96639C56.0521 3.41627 59.4222 2.01747 63.0527 2.01747C66.6832 2.01747 70.0404 3.41627 72.5797 5.96639Z" fill="#1A1751"/>
+<path d="M29.9043 1.58813H34.9312L40.4294 18.0967H40.7641L40.3281 1.58813H45.7933V29.4026H40.7664L35.2682 12.861H34.9335L35.3695 29.4026H29.9043V1.58813Z" fill="#1A1751"/>
+<path d="M92.4311 16.7957C91.915 16.0179 91.314 15.325 90.6271 14.7181L86.5712 11.0379C85.9985 10.5099 85.586 10.0032 85.3339 9.51417C85.0817 9.0263 84.9556 8.53137 84.9556 8.03053C84.9556 7.47667 85.1041 7.03476 85.4022 6.7048C85.7003 6.37484 86.101 6.20986 86.6053 6.20986C87.2004 6.20986 87.6364 6.38191 87.9109 6.72483C88.1855 7.06776 88.3234 7.56977 88.3234 8.22851V9.99144H93.6554V8.50544C93.6554 7.31876 93.5176 6.28292 93.243 5.3991C92.9685 4.51528 92.5443 3.78347 91.9716 3.20251C91.3989 2.59562 90.6601 2.14074 89.7551 1.83671C88.8501 1.53385 87.9569 1.38184 86.6053 1.38184C85.4823 1.38184 84.4631 1.53385 83.5463 1.83671C82.6295 2.14074 81.8507 2.59562 81.2096 3.20251C80.6369 3.78347 80.1786 4.50821 79.8345 5.37907C79.4904 6.24993 79.3184 7.25277 79.3184 8.38642C79.3184 9.41519 79.4727 10.3721 79.7826 11.2559C80.0925 12.1397 80.5215 12.9575 81.0718 13.7094C81.622 14.4612 82.2513 15.1671 82.9618 15.827L86.8457 19.3493C87.3724 19.8514 87.7613 20.3522 88.0146 20.853C88.2668 21.355 88.3929 21.9607 88.3929 22.6737C88.3929 23.3336 88.2326 23.8545 87.9121 24.2363C87.5904 24.6193 87.1438 24.8102 86.5723 24.8102C86.0008 24.8102 85.5519 24.6063 85.2314 24.1962C84.9097 23.7873 84.7506 23.2405 84.7506 22.5535V19.7642H79.4185V22.1575C79.4185 23.3713 79.5564 24.446 79.8309 25.3829C80.1055 26.3198 80.5179 27.0916 81.0682 27.6985C81.6869 28.3584 82.4658 28.8463 83.4049 29.1633C84.3441 29.4803 85.2431 29.6382 86.5723 29.6382C87.786 29.6382 88.8525 29.4673 89.768 29.1232C90.6848 28.7803 91.4637 28.2924 92.1047 27.6584C92.7234 27.0256 93.1982 26.2538 93.5305 25.3428C93.8628 24.4331 94.029 23.3843 94.029 22.1964C94.029 21.1677 93.8911 20.2049 93.6166 19.3069C93.342 18.4101 92.9461 17.5723 92.4311 16.7945V16.7957Z" fill="#1A1751"/>
+<path d="M116.925 16.7957C116.409 16.0179 115.808 15.325 115.121 14.7181L111.065 11.0379C110.493 10.5099 110.08 10.0032 109.828 9.51417C109.576 9.0263 109.45 8.53137 109.45 8.03053C109.45 7.47667 109.598 7.03476 109.896 6.7048C110.194 6.37484 110.595 6.20986 111.099 6.20986C111.695 6.20986 112.131 6.38191 112.405 6.72483C112.68 7.06776 112.818 7.56977 112.818 8.22851V9.99144H118.15V8.50544C118.15 7.31876 118.012 6.28292 117.737 5.3991C117.463 4.51528 117.038 3.78347 116.466 3.20251C115.893 2.59562 115.154 2.14074 114.249 1.83671C113.344 1.53385 112.451 1.38184 111.099 1.38184C109.976 1.38184 108.957 1.53385 108.04 1.83671C107.124 2.14074 106.345 2.59562 105.704 3.20251C105.131 3.78347 104.673 4.50821 104.329 5.37907C103.985 6.24993 103.812 7.25277 103.812 8.38642C103.812 9.41519 103.967 10.3721 104.277 11.2559C104.587 12.1397 105.016 12.9575 105.566 13.7094C106.116 14.4612 106.745 15.1671 107.456 15.827L111.34 19.3493C111.867 19.8514 112.255 20.3522 112.509 20.853C112.761 21.355 112.887 21.9607 112.887 22.6737C112.887 23.3336 112.727 23.8545 112.406 24.2363C112.085 24.6193 111.638 24.8102 111.066 24.8102C110.495 24.8102 110.046 24.6063 109.726 24.1962C109.404 23.7873 109.245 23.2405 109.245 22.5535V19.7642H103.913V22.1575C103.913 23.3713 104.051 24.446 104.325 25.3829C104.6 26.3198 105.012 27.0916 105.562 27.6985C106.181 28.3584 106.96 28.8463 107.899 29.1633C108.838 29.4803 109.737 29.6382 111.066 29.6382C112.28 29.6382 113.347 29.4673 114.262 29.1232C115.179 28.7803 115.958 28.2924 116.599 27.6584C117.218 27.0256 117.692 26.2538 118.025 25.3428C118.357 24.4331 118.523 23.3843 118.523 22.1964C118.523 21.1677 118.385 20.2049 118.111 19.3069C117.836 18.4101 117.44 17.5723 116.925 16.7945V16.7957Z" fill="#1A1751"/>
+<rect width="1.92229" height="1.92241" transform="translate(88.8682 16.8975)" fill="#1A1751"/>
+<path d="M163.735 29.4404V17.9716L156.644 1.59912H160.291L165.397 14H165.599L170.746 1.59912H174.231L167.18 17.9716V29.4404H163.735Z" fill="#3F2ACD"/>
+<path d="M139.936 29.4404L146.622 1.59912H150.756L157.523 29.4404H153.957L152.133 21.9026H145.123L143.38 29.4404H139.936ZM145.69 18.9442H151.566L149.54 9.78534C149.297 8.81272 148.972 6.90801 148.77 5.69223H148.567C148.365 6.82695 148 8.73167 147.757 9.78534L145.69 18.9442Z" fill="#3F2ACD"/>
+<path d="M124.37 29.4406V1.59937H131.786C137.54 1.59937 139.283 5.12511 139.283 9.90716C139.283 15.0134 136.892 18.6607 132.07 18.6607H127.815V29.4406H124.37ZM127.815 15.6618H131.381C134.42 15.6618 135.757 13.4734 135.757 10.0693C135.757 6.42194 134.704 4.6388 131.219 4.6388H127.815V15.6618Z" fill="#3F2ACD"/>
+</svg>
diff --git a/static/img/logo-light.svg b/static/img/logo-light.svg
new file mode 100644
index 0000000..bc7e46e
--- /dev/null
+++ b/static/img/logo-light.svg
@@ -0,0 +1,12 @@
+<svg width="175" height="31" viewBox="0 0 175 31" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M13.6714 13.6646V18.4171H22.4361C21.345 21.7284 18.4238 24.3774 14.0226 24.3774C9.11467 24.3774 5.64909 20.4427 5.64909 15.4959C5.64909 10.549 9.27022 6.61434 14.3337 6.61434C16.6444 6.61434 18.5734 7.39325 20.0134 8.66591C20.6002 9.20326 21.4039 10.1318 21.6961 11.3833H27.3652C27.3652 11.3833 27.4018 9.91736 26.4485 8.05433C26.4485 8.05433 26.4473 8.05197 26.4461 8.05079C25.8817 6.95018 24.9708 5.71051 23.5014 4.55333C23.4919 4.54626 23.4825 4.53919 23.4731 4.53212C21.0539 2.52768 17.8464 1.354 14.0603 1.354C5.95783 1.35518 0 7.50991 0 15.4959C0 23.4818 5.95783 29.6365 14.0214 29.6365C22.085 29.6365 28.084 23.6374 28.084 15.847V13.6658H13.6714V13.6646Z" fill="white"/>
+<path d="M96.1465 29.4026V1.58789H101.639V29.4014H96.1465V29.4026Z" fill="white"/>
+<path d="M73.4566 13.6163C73.4566 12.6783 73.1479 11.8263 72.6141 11.1499L66.9662 16.7956C67.6543 17.3294 68.5075 17.6381 69.4337 17.6381C71.6643 17.637 73.4684 15.8352 73.4566 13.6163ZM56.6566 17.624C54.4378 17.6358 52.6337 15.8328 52.6337 13.6022C52.6337 12.6771 52.9424 11.824 53.4762 11.1358L59.1241 16.7815C58.4477 17.3153 57.5946 17.624 56.6566 17.624ZM52.2908 9.97389C51.46 10.9708 50.9616 12.227 50.9616 13.6269C50.9616 16.7697 53.5127 19.3197 56.6566 19.3197C58.0447 19.3197 59.3138 18.8212 60.3107 17.9905L63.0516 20.7302L65.7925 17.9905C66.7894 18.8212 68.0467 19.3197 69.4466 19.3197C72.5905 19.3197 75.1417 16.7697 75.1417 13.6269C75.1417 12.2399 74.6432 10.9696 73.8137 9.97389L76.3165 7.47217C77.7412 9.81952 78.559 12.5593 78.559 15.5017C78.559 24.0651 71.6184 30.9917 63.0634 30.9917C54.5085 30.9917 47.5679 24.0533 47.5679 15.5017C47.5443 12.5487 48.3633 9.80892 49.7867 7.47217L52.2896 9.97389H52.2908ZM63.0634 18.3593L75.3561 6.07224C75.0121 5.6327 74.6456 5.20613 74.2638 4.8043C71.4404 1.85007 67.4658 0 63.0516 0C58.6375 0 54.6522 1.85007 51.8395 4.80312C51.4482 5.19434 51.0794 5.63388 50.7707 6.05928L63.0634 18.3581V18.3593ZM72.5799 5.96619L63.0528 15.4899L53.5257 5.96619C56.0521 3.41615 59.4223 2.0174 63.0528 2.0174C66.6834 2.0174 70.0405 3.41615 72.5799 5.96619Z" fill="white"/>
+<path d="M29.9043 1.58789H34.9312L40.4295 18.096H40.7641L40.3281 1.58789H45.7934V29.4014H40.7665L35.2682 12.8604H34.9336L35.3696 29.4014H29.9043V1.58789Z" fill="white"/>
+<path d="M92.4312 16.7942C91.9151 16.0165 91.3141 15.3236 90.6271 14.7167L86.5712 11.0366C85.9985 10.5087 85.5861 10.002 85.3339 9.51293C85.0818 9.02508 84.9557 8.53015 84.9557 8.02934C84.9557 7.47549 85.1041 7.0336 85.4023 6.70365C85.7004 6.3737 86.101 6.20872 86.6054 6.20872C87.2005 6.20872 87.6365 6.38077 87.911 6.72368C88.1856 7.06659 88.3234 7.56859 88.3234 8.22731V9.99018H93.6556V8.50423C93.6556 7.31759 93.5177 6.28178 93.2431 5.39799C92.9686 4.5142 92.5443 3.78242 91.9717 3.20147C91.399 2.5946 90.6601 2.13974 89.7552 1.83572C88.8502 1.53287 87.957 1.38086 86.6054 1.38086C85.4824 1.38086 84.4631 1.53287 83.5463 1.83572C82.6296 2.13974 81.8507 2.5946 81.2096 3.20147C80.637 3.78242 80.1786 4.50713 79.8345 5.37796C79.4904 6.24879 79.3184 7.2516 79.3184 8.38521C79.3184 9.41395 79.4727 10.3708 79.7826 11.2546C80.0925 12.1384 80.5215 12.9562 81.0718 13.708C81.6221 14.4598 82.2513 15.1657 82.9619 15.8256L86.8458 19.3478C87.3725 19.8498 87.7614 20.3506 88.0147 20.8514C88.2669 21.3534 88.393 21.9591 88.393 22.672C88.393 23.3319 88.2327 23.8528 87.9122 24.2346C87.5905 24.6175 87.1439 24.8084 86.5724 24.8084C86.0009 24.8084 85.5519 24.6046 85.2314 24.1945C84.9097 23.7856 84.7506 23.2388 84.7506 22.5518V19.7626H79.4185V22.1559C79.4185 23.3696 79.5564 24.4443 79.8309 25.3811C80.1055 26.318 80.5179 27.0898 81.0682 27.6967C81.6869 28.3566 82.4658 28.8444 83.4049 29.1614C84.3441 29.4784 85.2432 29.6363 86.5724 29.6363C87.7861 29.6363 88.8525 29.4654 89.7681 29.1213C90.6849 28.7784 91.4638 28.2906 92.1048 27.6566C92.7235 27.0238 93.1983 26.252 93.5306 25.3411C93.8629 24.4314 94.0291 23.3826 94.0291 22.1948C94.0291 21.166 93.8912 20.2033 93.6167 19.3054C93.3421 18.4086 92.9462 17.5708 92.4312 16.793V16.7942Z" fill="white"/>
+<path d="M116.928 16.7942C116.412 16.0165 115.811 15.3236 115.124 14.7167L111.068 11.0366C110.496 10.5087 110.083 10.002 109.831 9.51293C109.579 9.02508 109.453 8.53015 109.453 8.02934C109.453 7.47549 109.601 7.0336 109.899 6.70365C110.197 6.3737 110.598 6.20872 111.102 6.20872C111.698 6.20872 112.134 6.38077 112.408 6.72368C112.683 7.06659 112.821 7.56859 112.821 8.22731V9.99018H118.153V8.50423C118.153 7.31759 118.015 6.28178 117.74 5.39799C117.466 4.5142 117.041 3.78242 116.469 3.20147C115.896 2.5946 115.157 2.13974 114.252 1.83572C113.347 1.53287 112.454 1.38086 111.102 1.38086C109.979 1.38086 108.96 1.53287 108.043 1.83572C107.127 2.13974 106.348 2.5946 105.707 3.20147C105.134 3.78242 104.676 4.50713 104.332 5.37796C103.987 6.24879 103.815 7.2516 103.815 8.38521C103.815 9.41395 103.97 10.3708 104.28 11.2546C104.59 12.1384 105.019 12.9562 105.569 13.708C106.119 14.4598 106.748 15.1657 107.459 15.8256L111.343 19.3478C111.87 19.8498 112.258 20.3506 112.512 20.8514C112.764 21.3534 112.89 21.9591 112.89 22.672C112.89 23.3319 112.73 23.8528 112.409 24.2346C112.088 24.6175 111.641 24.8084 111.069 24.8084C110.498 24.8084 110.049 24.6046 109.728 24.1945C109.407 23.7856 109.248 23.2388 109.248 22.5518V19.7626H103.916V22.1559C103.916 23.3696 104.053 24.4443 104.328 25.3811C104.603 26.318 105.015 27.0898 105.565 27.6967C106.184 28.3566 106.963 28.8444 107.902 29.1614C108.841 29.4784 109.74 29.6363 111.069 29.6363C112.283 29.6363 113.35 29.4654 114.265 29.1213C115.182 28.7784 115.961 28.2906 116.602 27.6566C117.221 27.0238 117.695 26.252 118.028 25.3411C118.36 24.4314 118.526 23.3826 118.526 22.1948C118.526 21.166 118.388 20.2033 118.114 19.3054C117.839 18.4086 117.443 17.5708 116.928 16.793V16.7942Z" fill="white"/>
+<rect width="1.92231" height="1.92234" transform="translate(88.8701 16.8972)" fill="white"/>
+<path d="M163.739 29.4392V17.9708L156.647 1.59888H160.295L165.401 13.9994H165.603L170.75 1.59888H174.235L167.184 17.9708V29.4392H163.739Z" fill="#CBFB6C"/>
+<path d="M139.938 29.4392L146.625 1.59888H150.759L157.526 29.4392H153.96L152.136 21.9017H145.126L143.383 29.4392H139.938ZM145.693 18.9434H151.569L149.543 9.78483C149.3 8.81224 148.975 6.90759 148.773 5.69185H148.57C148.368 6.82654 148.003 8.73119 147.76 9.78483L145.693 18.9434Z" fill="#CBFB6C"/>
+<path d="M124.372 29.439V1.59863H131.788C137.543 1.59863 139.285 5.12427 139.285 9.90616C139.285 15.0122 136.894 18.6595 132.072 18.6595H127.817V29.439H124.372ZM127.817 15.6606H131.383C134.422 15.6606 135.759 13.4723 135.759 10.0683C135.759 6.42105 134.706 4.63797 131.221 4.63797H127.817V15.6606Z" fill="#CBFB6C"/>
+</svg>
diff --git a/transactions/index.mdx b/transactions/index.mdx
deleted file mode 100644
index efb377e..0000000
--- a/transactions/index.mdx
+++ /dev/null
@@ -1,160 +0,0 @@
----
-title: "Card Transactions Overview"
-description: "Comprehensive guide to understanding card transaction types, lifecycle, and integration patterns"
----
-
-Card transactions in Gnosis Pay follow the standard payment card industry lifecycle but with unique behaviors for different transaction kinds. This guide will help you understand how transactions work, when they appear in the API, and how to handle them in your integration.
-
-## Transaction Kinds
-
-The Gnosis Pay API returns three distinct types of transaction events, each with different behaviors and timing:
-
-### Payment
-Regular card transactions including purchases, ATM withdrawals, and other card usage.
-
-**Key Characteristics:**
-- **Immediate visibility**: Appears in the API immediately after authorization
-- **Status tracking**: Has a `status` field indicating approval, decline reasons, or reversals
-- **Pending behavior**: Shows `isPending: true` when authorized but not yet settled
-- **Settlement timing**: Usually settles within 24 hours, but can take up to a month for certain merchants (hotels, car rentals)
-
-**Common scenarios:**
-- Point-of-sale purchases
-- ATM cash withdrawals
-- Online purchases
-- Hotel pre-authorizations
-
-### Refund
-Money being returned to the cardholder's account, typically from product returns or service cancellations.
-
-**Key Characteristics:**
-- **Delayed visibility**: Only appears after both authorization AND clearing are processed
-- **No status field**: Unlike payments, refunds don't have approval/decline status
-- **Amount fields**: Includes `refundAmount` and `refundCurrency` fields
-- **Pending behavior**: Can still show `isPending: true` if additional clearing steps are required
-
-**Common scenarios:**
-- Product returns to merchants
-- Service cancellations
-- Merchant-initiated refunds
-- Dispute resolutions
-
-### Reversal
-Cancellation or reversal of previous transactions, often due to technical issues or merchant corrections.
-
-**Key Characteristics:**
-- **Variable timing**: Can appear immediately (authorization-level) or after clearing
-- **Amount fields**: Includes `reversalAmount` and `reversalCurrency` fields
-- **Quick processing**: Usually processed faster than refunds
-- **No status field**: Similar to refunds, no approval/decline status
-
-**Common scenarios:**
-- Duplicate transaction corrections
-- Technical payment processing errors
-- Merchant-initiated transaction cancellations
-- Partial transaction reversals
-
-## Transaction Lifecycle
-
-Understanding the transaction lifecycle is crucial for proper integration:
-
-### Authorization Phase
-1. **Card Usage**: Customer uses card at merchant
-2. **Authorization Request**: Merchant requests payment authorization
-3. **Real-time Processing**: Gnosis Pay validates funds, limits, and fraud checks
-4. **Response**: Authorization approved or declined
-5. **API Visibility**:
-   - **Payments**: Immediately visible with `isPending: true`
-   - **Refunds**: Not yet visible (requires clearing)
-   - **Reversals**: May be visible if authorization-level reversal
-
-### Clearing Phase
-1. **Settlement Processing**: Usually within 24 hours (can be longer for certain MCCs)
-2. **Final Amount**: May differ from authorization amount
-3. **API Updates**:
-   - **Payments**: `isPending` becomes `false`, `clearedAt` is set
-   - **Refunds**: Now become visible in the API
-   - **Reversals**: Update with final amounts and timing
-
-## Integration Best Practices
-
-### Handling Different Transaction Kinds
-
-```javascript
-// Example: Processing different transaction types
-transactions.forEach(transaction => {
-  switch (transaction.kind) {
-    case 'Payment':
-      if (transaction.isPending) {
-        // Handle pending payment
-        console.log(`Pending payment: ${transaction.billingAmount}`);
-        // Show as "Processing" in UI
-      } else {
-        // Handle completed payment
-        console.log(`Completed payment: ${transaction.status}`);
-      }
-      break;
-
-    case 'Refund':
-      // Refunds are typically not pending when they appear
-      console.log(`Refund received: ${transaction.refundAmount}`);
-      // Update account balance, notify user
-      break;
-
-    case 'Reversal':
-      // Handle transaction reversal
-      console.log(`Transaction reversed: ${transaction.reversalAmount}`);
-      // Reverse previous transaction effects
-      break;
-  }
-});
-```
-
-### Monitoring Transaction Status
-
-```javascript
-// Example: Monitoring pending transactions
-const monitorPendingTransactions = async () => {
-  const response = await fetch('/api/v1/cards/transactions');
-  const data = await response.json();
-
-  const pendingTransactions = data.results.filter(t => t.isPending);
-
-  if (pendingTransactions.length > 0) {
-    console.log(`${pendingTransactions.length} transactions pending settlement`);
-    // Schedule next check or set up webhooks for updates
-  }
-};
-```
-
-### Error Handling
-
-Different transaction kinds may have different error scenarios:
-
-- **Payments**: Can be declined for various reasons (insufficient funds, incorrect PIN, etc.)
-- **Refunds**: Usually appear only when successfully processed
-- **Reversals**: Indicate correction of previous errors
-
-## Common Integration Patterns
-
-### Real-time Balance Updates
-- **Payments**: Money is immediately deducted from user account and moved to hold account on chain when `isPending: true`
-- **Refunds**: Add to balance when transaction appears (usually already cleared)
-- **Reversals**: Adjust balance based on reversal type and amount
-
-### User Notifications
-- **Payments**: Notify immediately for both pending and completed
-- **Refunds**: Notify when refund appears (money is being returned)
-- **Reversals**: Notify about transaction corrections
-
-### Transaction History Display
-- Show transaction kind clearly in the UI
-- Use `isPending` status for appropriate visual indicators
-- Handle currency conversions (billing vs transaction currency)
-- Display appropriate amounts based on transaction kind
-
-## Next Steps
-
-- [Transaction Lifecycle Details](/transactions/lifecycle) - Deep dive into authorization and clearing
-- [API Integration Guide](/transactions/integration-guide) - Complete integration examples
-- [API Reference](/api-reference/transactions/list-card-transactions) - Full API documentation
diff --git a/transactions/integration-guide.mdx b/transactions/integration-guide.mdx
deleted file mode 100644
index c2d5b0f..0000000
--- a/transactions/integration-guide.mdx
+++ /dev/null
@@ -1,244 +0,0 @@
----
-title: "Transaction Integration Guide"
-description: "Complete examples and best practices for integrating with Gnosis Pay transaction APIs"
----
-
-This guide provides comprehensive examples and patterns for integrating with Gnosis Pay's transaction APIs, covering all three transaction kinds and their unique behaviors.
-
-## Basic Integration Setup
-
-### Authentication and API Setup
-
-<CodeGroup>
-
-```javascript JavaScript
-const GNOSIS_PAY_API = 'https://api.gnosispay.com';
-
-class GnosisPayClient {
-  constructor(authToken) {
-    this.authToken = authToken;
-  }
-
-  async getTransactions(params = {}) {
-    const queryParams = new URLSearchParams(params);
-    const response = await fetch(
-      `${GNOSIS_PAY_API}/api/v1/cards/transactions?${queryParams}`,
-      {
-        headers: {
-          'Authorization': `Bearer ${this.authToken}`,
-          'Content-Type': 'application/json'
-        }
-      }
-    );
-
-    if (!response.ok) {
-      throw new Error(`API Error: ${response.status}`);
-    }
-
-    return response.json();
-  }
-}
-```
-
-```python Python
-import requests
-from typing import Dict, Any, Optional
-
-class GnosisPayClient:
-    def __init__(self, auth_token: str):
-        self.auth_token = auth_token
-        self.base_url = "https://api.gnosispay.com"
-
-    def get_transactions(self, params: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
-        headers = {
-            "Authorization": f"Bearer {self.auth_token}",
-            "Content-Type": "application/json"
-        }
-
-        response = requests.get(
-            f"{self.base_url}/api/v1/cards/transactions",
-            headers=headers,
-            params=params or {}
-        )
-
-        response.raise_for_status()
-        return response.json()
-```
-
-```curl cURL
-# Get all transactions
-curl -X GET "https://api.gnosispay.com/api/v1/cards/transactions" \
-  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
-  -H "Content-Type: application/json"
-
-# Get transactions with filters
-curl -X GET "https://api.gnosispay.com/api/v1/cards/transactions?limit=50&after=2024-01-01T00:00:00Z" \
-  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
-  -H "Content-Type: application/json"
-```
-
-</CodeGroup>
-
-## Handling Different Transaction Kinds
-
-### Transaction Processing Logic
-
-<CodeGroup>
-
-```javascript JavaScript
-class TransactionProcessor {
-  processTransactions(transactions) {
-    const processed = {
-      payments: { pending: [], completed: [] },
-      refunds: [],
-      reversals: []
-    };
-
-    transactions.forEach(transaction => {
-      switch (transaction.kind) {
-        case 'Payment':
-          this.processPayment(transaction, processed);
-          break;
-        case 'Refund':
-          this.processRefund(transaction, processed);
-          break;
-        case 'Reversal':
-          this.processReversal(transaction, processed);
-          break;
-        default:
-          console.warn('Unknown transaction kind:', transaction.kind);
-      }
-    });
-
-    return processed;
-  }
-
-  processPayment(payment, processed) {
-    if (payment.isPending) {
-      processed.payments.pending.push({
-        ...payment,
-        displayStatus: 'Processing',
-        balanceImpact: -parseInt(payment.billingAmount), // Already deducted
-        canCancel: this.canCancelPayment(payment)
-      });
-    } else {
-      processed.payments.completed.push({
-        ...payment,
-        displayStatus: this.getPaymentDisplayStatus(payment),
-        balanceImpact: 0, // Already accounted for when pending
-        settlementDate: payment.clearedAt
-      });
-    }
-  }
-
-  processRefund(refund, processed) {
-    processed.refunds.push({
-      ...refund,
-      displayStatus: 'Refund Processed',
-      balanceImpact: parseInt(refund.refundAmount), // Money returned
-      refundDate: refund.clearedAt,
-      originalTransaction: this.findOriginalTransaction(refund)
-    });
-  }
-
-  processReversal(reversal, processed) {
-    processed.reversals.push({
-      ...reversal,
-      displayStatus: 'Transaction Reversed',
-      balanceImpact: parseInt(reversal.reversalAmount), // Money returned
-      reversalDate: reversal.clearedAt,
-      reversalReason: this.determineReversalReason(reversal)
-    });
-  }
-
-  getPaymentDisplayStatus(payment) {
-    switch (payment.status) {
-      case 'Approved': return 'Completed';
-      case 'IncorrectPin': return 'Failed - Incorrect PIN';
-      case 'InsufficientFunds': return 'Failed - Insufficient Funds';
-      case 'Reversal': return 'Reversed';
-      case 'PartialReversal': return 'Partially Reversed';
-      default: return 'Completed';
-    }
-  }
-}
-```
-
-```python Python
-from dataclasses import dataclass
-from typing import List, Dict, Any
-from datetime import datetime
-
-@dataclass
-class ProcessedTransaction:
-    original: Dict[str, Any]
-    display_status: str
-    balance_impact: int
-    additional_info: Dict[str, Any]
-
-class TransactionProcessor:
-    def process_transactions(self, transactions: List[Dict[str, Any]]) -> Dict[str, List]:
-        processed = {
-            "payments": {"pending": [], "completed": []},
-            "refunds": [],
-            "reversals": []
-        }
-
-        for transaction in transactions:
-            kind = transaction.get("kind")
-
-            if kind == "Payment":
-                self._process_payment(transaction, processed)
-            elif kind == "Refund":
-                self._process_refund(transaction, processed)
-            elif kind == "Reversal":
-                self._process_reversal(transaction, processed)
-            else:
-                print(f"Warning: Unknown transaction kind: {kind}")
-
-        return processed
-
-    def _process_payment(self, payment: Dict[str, Any], processed: Dict):
-        if payment.get("isPending"):
-            processed["payments"]["pending"].append(
-                ProcessedTransaction(
-                    original=payment,
-                    display_status="Processing",
-                    balance_impact=-int(payment["billingAmount"]),
-                    additional_info={
-                        "can_cancel": self._can_cancel_payment(payment),
-                        "estimated_settlement": self._estimate_settlement_time(payment)
-                    }
-                )
-            )
-        else:
-            processed["payments"]["completed"].append(
-                ProcessedTransaction(
-                    original=payment,
-                    display_status=self._get_payment_display_status(payment),
-                    balance_impact=0,  # Already accounted for when pending
-                    additional_info={
-                        "settlement_date": payment.get("clearedAt")
-                    }
-                )
-            )
-
-    def _get_payment_display_status(self, payment: Dict[str, Any]) -> str:
-        status_map = {
-            "Approved": "Completed",
-            "IncorrectPin": "Failed - Incorrect PIN",
-            "InsufficientFunds": "Failed - Insufficient Funds",
-            "Reversal": "Reversed",
-            "PartialReversal": "Partially Reversed"
-        }
-        return status_map.get(payment.get("status"), "Completed")
-```
-
-</CodeGroup>
-
-
-## Next Steps
-
-- [Transaction Lifecycle](/transactions/lifecycle) - Understand the detailed flow
-- [API Reference](/api-reference/transactions/list-card-transactions) - Complete API documentation
-- [Transaction Overview](/transactions) - Back to main guide
diff --git a/transactions/lifecycle.mdx b/transactions/lifecycle.mdx
deleted file mode 100644
index 9d36516..0000000
--- a/transactions/lifecycle.mdx
+++ /dev/null
@@ -1,195 +0,0 @@
----
-title: "Transaction Lifecycle"
-description: "Deep dive into the authorization and clearing process for card transactions"
----
-
-Understanding the transaction lifecycle is essential for building robust integrations with Gnosis Pay. This guide explains the detailed flow from card usage to final settlement.
-
-## Overview
-
-Card transactions follow a two-phase process:
-
-1. **Authorization Phase**: Real-time approval/decline of the transaction
-2. **Clearing Phase**: Final settlement and fund transfer (usually 24-48 hours later)
-
-Different transaction kinds have different behaviors in each phase.
-
-## Authorization Phase
-
-### Payment Authorization
-
-When a customer uses their Gnosis Pay card:
-
-<Steps>
-  <Step title="Card Presentation">
-    Customer presents card at merchant (physical swipe/insert or online entry)
-  </Step>
-  <Step title="Authorization Request">
-    Merchant's payment processor sends authorization request to Gnosis Pay
-  </Step>
-  <Step title="Real-time Validation">
-    Gnosis Pay performs multiple checks:
-    - Available balance verification
-    - Card status (active, not frozen)
-    - Spending limits compliance
-    - Anti-fraud analysis
-    - AML screening
-  </Step>
-  <Step title="Authorization Response">
-    Gnosis Pay responds with approval or decline
-  </Step>
-  <Step title="Fund Deduction">
-    If approved, money is immediately deducted from user account and moved to hold account on chain
-  </Step>
-  <Step title="API Visibility">
-    Transaction appears immediately in `/api/v1/cards/transactions` with:
-    - `kind: "Payment"`
-    - `isPending: true`
-    - `clearedAt: null`
-    - `status: "Approved"` (or decline reason)
-  </Step>
-</Steps>
-
-### Refund Authorization
-
-Refunds have a different authorization flow:
-
-<Steps>
-  <Step title="Merchant Initiation">
-    Merchant initiates refund (product return, service cancellation)
-  </Step>
-  <Step title="Refund Authorization">
-    Merchant sends refund authorization request
-  </Step>
-  <Step title="Authorization Processing">
-    Gnosis Pay validates the refund request
-  </Step>
-  <Step title="No Immediate API Visibility">
-    **Important**: Refund does NOT appear in API yet - requires clearing
-  </Step>
-</Steps>
-
-### Reversal Authorization
-
-Reversals can happen at the authorization level:
-
-<Steps>
-  <Step title="Error Detection">
-    System or merchant detects transaction error
-  </Step>
-  <Step title="Reversal Request">
-    Immediate reversal request sent
-  </Step>
-  <Step title="Authorization Reversal">
-    Original authorization is reversed
-  </Step>
-  <Step title="API Visibility">
-    May appear immediately as reversal or update original payment status
-  </Step>
-</Steps>
-
-## Clearing Phase
-
-The clearing phase typically occurs 24-48 hours after authorization, but timing varies by merchant type.
-
-### Standard Clearing Timeline
-
-- **Most merchants**: 24-48 hours
-- **Hotels**: Can be up to 30 days (for incidentals)
-- **Car rentals**: Up to 30 days
-- **Airlines**: Usually 24-48 hours
-- **Gas stations**: Often same day
-
-### Payment Clearing
-
-<Steps>
-  <Step title="Clearing Initiation">
-    Merchant submits clearing record (usually batch processed overnight)
-  </Step>
-  <Step title="Amount Reconciliation">
-    Clearing amount may differ from authorization:
-    - **Exact match**: Most common scenario
-    - **Partial capture**: Lower amount (unused authorization released)
-    - **Over capture**: Higher amount (allowed for specific MCCs like hotels)
-  </Step>
-  <Step title="Final Settlement">
-    Money is transferred from hold account on chain to merchant
-  </Step>
-  <Step title="API Update">
-    Transaction updates in API:
-    - `isPending: false`
-    - `clearedAt: "2024-01-15T02:30:00Z"`
-    - Amounts may be updated if different from authorization
-  </Step>
-</Steps>
-
-### Refund Clearing
-
-Refunds require both authorization AND clearing to appear:
-
-<Steps>
-  <Step title="Credit Voucher Processing">
-    Merchant submits credit voucher (BaseII transaction code "06")
-  </Step>
-  <Step title="Refund Validation">
-    System validates refund against original transaction
-  </Step>
-  <Step title="Fund Credit">
-    Funds are credited back to cardholder account
-  </Step>
-  <Step title="API Appearance">
-    Refund now appears in API:
-    - `kind: "Refund"`
-    - `isPending: false` (usually)
-    - `clearedAt: "2024-01-15T08:20:00Z"`
-    - `refundAmount` and `refundCurrency` fields
-  </Step>
-</Steps>
-
-
-## Edge Cases and Special Scenarios
-
-### Partial Authorizations and Captures
-
-Some merchants may:
-- **Partial capture**: Capture less than authorized amount
-- **Multi capture**: Multiple captures on single authorization
-- **Incremental authorization**: Additional authorizations (hotels for incidentals)
-
-### Force Captures
-
-Rare but possible scenarios:
-- **Offline transactions**: POS terminals without internet (airlines)
-- **Force capture**: Capture on previously declined authorization
-
-### Authorization Expiry
-
-If not captured within time limits:
-- Authorization expires (typically 7-30 days)
-- Money is returned from hold account back to user account on chain
-- Transaction may disappear from API or show as expired
-
-## Webhook Integration
-
-For real-time updates, consider implementing webhooks to be notified when:
-- Pending payments are settled
-- Refunds are processed
-- Reversals occur
-
-## Troubleshooting Common Issues
-
-### Missing Transactions
-- **Payments not appearing**: Check authorization was approved
-- **Refunds not appearing**: Ensure both authorization and clearing completed
-- **Delayed settlements**: Some MCCs have extended clearing times
-
-
-### Status Confusion
-- **isPending behavior**: Different meanings for different transaction kinds
-- **Timing expectations**: Clearing can take hours to days depending on merchant
-
-## Next Steps
-
-- [Integration Guide](/transactions/integration-guide) - Complete implementation examples
-- [API Reference](/api-reference/transactions/list-card-transactions) - Full API documentation
-- [Transaction Overview](/transactions) - Back to main transactions guide
diff --git a/webhooks/events.mdx b/webhooks/events.mdx
deleted file mode 100644
index 0ceec89..0000000
--- a/webhooks/events.mdx
+++ /dev/null
@@ -1,12270 +0,0 @@
-## KYC Events
-
-### kyc.phone-validation.changed
-
-Triggered when a user's phone validation status changes.
-
-**Event Type**: `kyc.phone-validation.changed`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "kyc.phone-validation.changed";
-  data: {
-    /** Unique user identifier */
-    id: string;
-    /** User email address */
-    email: string;
-    /** User phone number */
-    phone: string;
-    /** User first name */
-    firstName: string;
-    /** User last name */
-    lastName: string;
-    /** Primary address line */
-    address1: string;
-    /** Secondary address line */
-    address2: string;
-    /** City */
-    city: string;
-    /** Postal/ZIP code */
-    postalCode: string;
-    /** State/Province */
-    state: string;
-    /** Country */
-    country: string;
-    /** Nationality country */
-    nationalityCountry: string;
-    /** User's sign-in wallet addresses */
-    signInWallets: {
-      /** Wallet address */
-      address: string;
-    }[];
-    /** User's safe wallet addresses */
-    safeWallets: {
-      /** Safe wallet address */
-      address: string;
-      /** Blockchain chain ID */
-      chainId: string;
-    }[];
-    /** KYC verification status */
-    kycStatus: "notStarted" | "documentsRequested" | "pending" | "processing" | "approved" | "resubmissionRequested" | "rejected" | "requiresAction";
-    /** Available features for the user */
-    availableFeatures: {
-      /** Whether Monerium IBAN is available */
-      moneriumIban: boolean;
-    };
-    /** User's cards */
-    cards: {
-      /** Card ID */
-      id: string;
-      /** Card token */
-      cardToken: string;
-      /** Last four digits of card */
-      lastFourDigits: string;
-      /** Name embossed on card */
-      embossedName: string;
-      /** Card activation timestamp */
-      activatedAt: string;
-      /** Whether card is virtual */
-      virtual: boolean;
-    }[];
-    /** User's banking details */
-    bankingDetails: {
-      /** Monerium IBAN */
-      moneriumIban: string;
-      /** Monerium BIC */
-      moneriumBic: string;
-      /** Monerium IBAN status */
-      moneriumIbanStatus: string;
-      /** Banking address */
-      address: string;
-    };
-    /** Whether source of funds question was answered */
-    isSourceOfFundsAnswered: boolean;
-    /** Whether phone number is validated */
-    isPhoneValidated: boolean;
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "kyc.phone-validation.changed Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when a user's phone validation status changes."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "kyc.phone-validation.changed"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "id": {
-                "type": "string",
-                "description": "Unique user identifier"
-              },
-              "email": {
-                "type": "string",
-                "nullable": true,
-                "description": "User email address"
-              },
-              "phone": {
-                "type": "string",
-                "nullable": true,
-                "description": "User phone number"
-              },
-              "firstName": {
-                "type": "string",
-                "nullable": true,
-                "description": "User first name"
-              },
-              "lastName": {
-                "type": "string",
-                "nullable": true,
-                "description": "User last name"
-              },
-              "address1": {
-                "type": "string",
-                "nullable": true,
-                "description": "Primary address line"
-              },
-              "address2": {
-                "type": "string",
-                "nullable": true,
-                "description": "Secondary address line"
-              },
-              "city": {
-                "type": "string",
-                "nullable": true,
-                "description": "City"
-              },
-              "postalCode": {
-                "type": "string",
-                "nullable": true,
-                "description": "Postal/ZIP code"
-              },
-              "state": {
-                "type": "string",
-                "nullable": true,
-                "description": "State/Province"
-              },
-              "country": {
-                "type": "string",
-                "nullable": true,
-                "description": "Country"
-              },
-              "nationalityCountry": {
-                "type": "string",
-                "nullable": true,
-                "description": "Nationality country"
-              },
-              "signInWallets": {
-                "type": "array",
-                "items": {
-                  "type": "object",
-                  "properties": {
-                    "address": {
-                      "type": "string",
-                      "description": "Wallet address"
-                    }
-                  },
-                  "required": [
-                    "address"
-                  ]
-                },
-                "description": "User's sign-in wallet addresses"
-              },
-              "safeWallets": {
-                "type": "array",
-                "items": {
-                  "type": "object",
-                  "properties": {
-                    "address": {
-                      "type": "string",
-                      "description": "Safe wallet address"
-                    },
-                    "chainId": {
-                      "type": "string",
-                      "description": "Blockchain chain ID"
-                    }
-                  },
-                  "required": [
-                    "address",
-                    "chainId"
-                  ]
-                },
-                "description": "User's safe wallet addresses"
-              },
-              "kycStatus": {
-                "type": "string",
-                "enum": [
-                  "notStarted",
-                  "documentsRequested",
-                  "pending",
-                  "processing",
-                  "approved",
-                  "resubmissionRequested",
-                  "rejected",
-                  "requiresAction"
-                ],
-                "description": "KYC verification status",
-                "example": "approved"
-              },
-              "availableFeatures": {
-                "type": "object",
-                "properties": {
-                  "moneriumIban": {
-                    "type": "boolean",
-                    "description": "Whether Monerium IBAN is available"
-                  }
-                },
-                "required": [
-                  "moneriumIban"
-                ],
-                "description": "Available features for the user"
-              },
-              "cards": {
-                "type": "array",
-                "items": {
-                  "type": "object",
-                  "properties": {
-                    "id": {
-                      "type": "string",
-                      "description": "Card ID"
-                    },
-                    "cardToken": {
-                      "type": "string",
-                      "description": "Card token"
-                    },
-                    "lastFourDigits": {
-                      "type": "string",
-                      "description": "Last four digits of card"
-                    },
-                    "embossedName": {
-                      "type": "string",
-                      "nullable": true,
-                      "description": "Name embossed on card"
-                    },
-                    "activatedAt": {
-                      "type": "string",
-                      "nullable": true,
-                      "description": "Card activation timestamp"
-                    },
-                    "virtual": {
-                      "type": "boolean",
-                      "description": "Whether card is virtual"
-                    }
-                  },
-                  "required": [
-                    "id",
-                    "cardToken",
-                    "lastFourDigits",
-                    "embossedName",
-                    "activatedAt",
-                    "virtual"
-                  ]
-                },
-                "description": "User's cards"
-              },
-              "bankingDetails": {
-                "type": "object",
-                "nullable": true,
-                "properties": {
-                  "moneriumIban": {
-                    "type": "string",
-                    "nullable": true,
-                    "description": "Monerium IBAN"
-                  },
-                  "moneriumBic": {
-                    "type": "string",
-                    "nullable": true,
-                    "description": "Monerium BIC"
-                  },
-                  "moneriumIbanStatus": {
-                    "type": "string",
-                    "nullable": true,
-                    "description": "Monerium IBAN status"
-                  },
-                  "address": {
-                    "type": "string",
-                    "nullable": true,
-                    "description": "Banking address"
-                  }
-                },
-                "required": [
-                  "moneriumIban",
-                  "moneriumBic",
-                  "moneriumIbanStatus",
-                  "address"
-                ],
-                "description": "User's banking details"
-              },
-              "isSourceOfFundsAnswered": {
-                "type": "boolean",
-                "description": "Whether source of funds question was answered"
-              },
-              "isPhoneValidated": {
-                "type": "boolean",
-                "description": "Whether phone number is validated"
-              }
-            },
-            "required": [
-              "id",
-              "email",
-              "phone",
-              "firstName",
-              "lastName",
-              "address1",
-              "address2",
-              "city",
-              "postalCode",
-              "state",
-              "country",
-              "nationalityCountry",
-              "signInWallets",
-              "safeWallets",
-              "kycStatus",
-              "availableFeatures",
-              "cards",
-              "bankingDetails",
-              "isSourceOfFundsAnswered",
-              "isPhoneValidated"
-            ],
-            "description": "User data structure",
-            "example": {
-              "id": "user_123",
-              "email": "user@example.com",
-              "phone": "+1234567890",
-              "firstName": "John",
-              "lastName": "Doe",
-              "address1": "123 Main Street",
-              "address2": "Apt 4B",
-              "city": "New York",
-              "postalCode": "10001",
-              "state": "NY",
-              "country": "US",
-              "nationalityCountry": "US",
-              "signInWallets": [
-                {
-                  "address": "0x1234567890abcdef1234567890abcdef12345678"
-                }
-              ],
-              "safeWallets": [
-                {
-                  "address": "0xabcdef1234567890abcdef1234567890abcdef12",
-                  "chainId": "100"
-                }
-              ],
-              "kycStatus": "approved",
-              "availableFeatures": {
-                "moneriumIban": true
-              },
-              "cards": [
-                {
-                  "id": "card_123",
-                  "cardToken": "card_token_456",
-                  "lastFourDigits": "1234",
-                  "embossedName": "John Doe",
-                  "activatedAt": "2024-01-15T10:30:00Z",
-                  "virtual": false
-                }
-              ],
-              "bankingDetails": {
-                "moneriumIban": "GB82WEST12345698765432",
-                "moneriumBic": "WESTGB22",
-                "moneriumIbanStatus": "ASSIGNED",
-                "address": "123 Main Street, New York, NY 10001"
-              },
-              "isSourceOfFundsAnswered": true,
-              "isPhoneValidated": true
-            }
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when a user's phone validation status changes.",
-        "example": {
-          "eventType": "kyc.phone-validation.changed",
-          "data": {
-            "id": "user_123",
-            "email": "user@example.com",
-            "phone": "+1234567890",
-            "firstName": "John",
-            "lastName": "Doe",
-            "address1": "123 Main Street",
-            "address2": "Apt 4B",
-            "city": "New York",
-            "postalCode": "10001",
-            "state": "NY",
-            "country": "US",
-            "nationalityCountry": "US",
-            "signInWallets": [
-              {
-                "address": "0x1234567890abcdef1234567890abcdef12345678"
-              }
-            ],
-            "safeWallets": [
-              {
-                "address": "0xabcdef1234567890abcdef1234567890abcdef12",
-                "chainId": "100"
-              }
-            ],
-            "kycStatus": "approved",
-            "availableFeatures": {
-              "moneriumIban": true
-            },
-            "cards": [
-              {
-                "id": "card_123",
-                "cardToken": "card_token_456",
-                "lastFourDigits": "1234",
-                "embossedName": "John Doe",
-                "activatedAt": "2024-01-15T10:30:00Z",
-                "virtual": false
-              }
-            ],
-            "bankingDetails": {
-              "moneriumIban": "GB82WEST12345698765432",
-              "moneriumBic": "WESTGB22",
-              "moneriumIbanStatus": "ASSIGNED",
-              "address": "123 Main Street, New York, NY 10001"
-            },
-            "isSourceOfFundsAnswered": true,
-            "isPhoneValidated": true
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "kyc.phone-validation.changed",
-  "data": {
-    "id": "user_123",
-    "email": "user@example.com",
-    "phone": "+1234567890",
-    "firstName": "John",
-    "lastName": "Doe",
-    "address1": "123 Main Street",
-    "address2": "Apt 4B",
-    "city": "New York",
-    "postalCode": "10001",
-    "state": "NY",
-    "country": "US",
-    "nationalityCountry": "US",
-    "signInWallets": [
-      {
-        "address": "0x1234567890abcdef1234567890abcdef12345678"
-      }
-    ],
-    "safeWallets": [
-      {
-        "address": "0xabcdef1234567890abcdef1234567890abcdef12",
-        "chainId": "100"
-      }
-    ],
-    "kycStatus": "approved",
-    "availableFeatures": {
-      "moneriumIban": true
-    },
-    "cards": [
-      {
-        "id": "card_123",
-        "cardToken": "card_token_456",
-        "lastFourDigits": "1234",
-        "embossedName": "John Doe",
-        "activatedAt": "2024-01-15T10:30:00Z",
-        "virtual": false
-      }
-    ],
-    "bankingDetails": {
-      "moneriumIban": "GB82WEST12345698765432",
-      "moneriumBic": "WESTGB22",
-      "moneriumIbanStatus": "ASSIGNED",
-      "address": "123 Main Street, New York, NY 10001"
-    },
-    "isSourceOfFundsAnswered": true,
-    "isPhoneValidated": true
-  }
-}
-```
-
-### kyc.source-of-funds.changed
-
-Triggered when a user's source of funds information changes.
-
-**Event Type**: `kyc.source-of-funds.changed`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "kyc.source-of-funds.changed";
-  data: {
-    /** Unique user identifier */
-    id: string;
-    /** User email address */
-    email: string;
-    /** User phone number */
-    phone: string;
-    /** User first name */
-    firstName: string;
-    /** User last name */
-    lastName: string;
-    /** Primary address line */
-    address1: string;
-    /** Secondary address line */
-    address2: string;
-    /** City */
-    city: string;
-    /** Postal/ZIP code */
-    postalCode: string;
-    /** State/Province */
-    state: string;
-    /** Country */
-    country: string;
-    /** Nationality country */
-    nationalityCountry: string;
-    /** User's sign-in wallet addresses */
-    signInWallets: {
-      /** Wallet address */
-      address: string;
-    }[];
-    /** User's safe wallet addresses */
-    safeWallets: {
-      /** Safe wallet address */
-      address: string;
-      /** Blockchain chain ID */
-      chainId: string;
-    }[];
-    /** KYC verification status */
-    kycStatus: "notStarted" | "documentsRequested" | "pending" | "processing" | "approved" | "resubmissionRequested" | "rejected" | "requiresAction";
-    /** Available features for the user */
-    availableFeatures: {
-      /** Whether Monerium IBAN is available */
-      moneriumIban: boolean;
-    };
-    /** User's cards */
-    cards: {
-      /** Card ID */
-      id: string;
-      /** Card token */
-      cardToken: string;
-      /** Last four digits of card */
-      lastFourDigits: string;
-      /** Name embossed on card */
-      embossedName: string;
-      /** Card activation timestamp */
-      activatedAt: string;
-      /** Whether card is virtual */
-      virtual: boolean;
-    }[];
-    /** User's banking details */
-    bankingDetails: {
-      /** Monerium IBAN */
-      moneriumIban: string;
-      /** Monerium BIC */
-      moneriumBic: string;
-      /** Monerium IBAN status */
-      moneriumIbanStatus: string;
-      /** Banking address */
-      address: string;
-    };
-    /** Whether source of funds question was answered */
-    isSourceOfFundsAnswered: boolean;
-    /** Whether phone number is validated */
-    isPhoneValidated: boolean;
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "kyc.source-of-funds.changed Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when a user's source of funds information changes."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "kyc.source-of-funds.changed"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "id": {
-                "type": "string",
-                "description": "Unique user identifier"
-              },
-              "email": {
-                "type": "string",
-                "nullable": true,
-                "description": "User email address"
-              },
-              "phone": {
-                "type": "string",
-                "nullable": true,
-                "description": "User phone number"
-              },
-              "firstName": {
-                "type": "string",
-                "nullable": true,
-                "description": "User first name"
-              },
-              "lastName": {
-                "type": "string",
-                "nullable": true,
-                "description": "User last name"
-              },
-              "address1": {
-                "type": "string",
-                "nullable": true,
-                "description": "Primary address line"
-              },
-              "address2": {
-                "type": "string",
-                "nullable": true,
-                "description": "Secondary address line"
-              },
-              "city": {
-                "type": "string",
-                "nullable": true,
-                "description": "City"
-              },
-              "postalCode": {
-                "type": "string",
-                "nullable": true,
-                "description": "Postal/ZIP code"
-              },
-              "state": {
-                "type": "string",
-                "nullable": true,
-                "description": "State/Province"
-              },
-              "country": {
-                "type": "string",
-                "nullable": true,
-                "description": "Country"
-              },
-              "nationalityCountry": {
-                "type": "string",
-                "nullable": true,
-                "description": "Nationality country"
-              },
-              "signInWallets": {
-                "type": "array",
-                "items": {
-                  "type": "object",
-                  "properties": {
-                    "address": {
-                      "type": "string",
-                      "description": "Wallet address"
-                    }
-                  },
-                  "required": [
-                    "address"
-                  ]
-                },
-                "description": "User's sign-in wallet addresses"
-              },
-              "safeWallets": {
-                "type": "array",
-                "items": {
-                  "type": "object",
-                  "properties": {
-                    "address": {
-                      "type": "string",
-                      "description": "Safe wallet address"
-                    },
-                    "chainId": {
-                      "type": "string",
-                      "description": "Blockchain chain ID"
-                    }
-                  },
-                  "required": [
-                    "address",
-                    "chainId"
-                  ]
-                },
-                "description": "User's safe wallet addresses"
-              },
-              "kycStatus": {
-                "type": "string",
-                "enum": [
-                  "notStarted",
-                  "documentsRequested",
-                  "pending",
-                  "processing",
-                  "approved",
-                  "resubmissionRequested",
-                  "rejected",
-                  "requiresAction"
-                ],
-                "description": "KYC verification status",
-                "example": "approved"
-              },
-              "availableFeatures": {
-                "type": "object",
-                "properties": {
-                  "moneriumIban": {
-                    "type": "boolean",
-                    "description": "Whether Monerium IBAN is available"
-                  }
-                },
-                "required": [
-                  "moneriumIban"
-                ],
-                "description": "Available features for the user"
-              },
-              "cards": {
-                "type": "array",
-                "items": {
-                  "type": "object",
-                  "properties": {
-                    "id": {
-                      "type": "string",
-                      "description": "Card ID"
-                    },
-                    "cardToken": {
-                      "type": "string",
-                      "description": "Card token"
-                    },
-                    "lastFourDigits": {
-                      "type": "string",
-                      "description": "Last four digits of card"
-                    },
-                    "embossedName": {
-                      "type": "string",
-                      "nullable": true,
-                      "description": "Name embossed on card"
-                    },
-                    "activatedAt": {
-                      "type": "string",
-                      "nullable": true,
-                      "description": "Card activation timestamp"
-                    },
-                    "virtual": {
-                      "type": "boolean",
-                      "description": "Whether card is virtual"
-                    }
-                  },
-                  "required": [
-                    "id",
-                    "cardToken",
-                    "lastFourDigits",
-                    "embossedName",
-                    "activatedAt",
-                    "virtual"
-                  ]
-                },
-                "description": "User's cards"
-              },
-              "bankingDetails": {
-                "type": "object",
-                "nullable": true,
-                "properties": {
-                  "moneriumIban": {
-                    "type": "string",
-                    "nullable": true,
-                    "description": "Monerium IBAN"
-                  },
-                  "moneriumBic": {
-                    "type": "string",
-                    "nullable": true,
-                    "description": "Monerium BIC"
-                  },
-                  "moneriumIbanStatus": {
-                    "type": "string",
-                    "nullable": true,
-                    "description": "Monerium IBAN status"
-                  },
-                  "address": {
-                    "type": "string",
-                    "nullable": true,
-                    "description": "Banking address"
-                  }
-                },
-                "required": [
-                  "moneriumIban",
-                  "moneriumBic",
-                  "moneriumIbanStatus",
-                  "address"
-                ],
-                "description": "User's banking details"
-              },
-              "isSourceOfFundsAnswered": {
-                "type": "boolean",
-                "description": "Whether source of funds question was answered"
-              },
-              "isPhoneValidated": {
-                "type": "boolean",
-                "description": "Whether phone number is validated"
-              }
-            },
-            "required": [
-              "id",
-              "email",
-              "phone",
-              "firstName",
-              "lastName",
-              "address1",
-              "address2",
-              "city",
-              "postalCode",
-              "state",
-              "country",
-              "nationalityCountry",
-              "signInWallets",
-              "safeWallets",
-              "kycStatus",
-              "availableFeatures",
-              "cards",
-              "bankingDetails",
-              "isSourceOfFundsAnswered",
-              "isPhoneValidated"
-            ],
-            "description": "User data structure",
-            "example": {
-              "id": "user_123",
-              "email": "user@example.com",
-              "phone": "+1234567890",
-              "firstName": "John",
-              "lastName": "Doe",
-              "address1": "123 Main Street",
-              "address2": "Apt 4B",
-              "city": "New York",
-              "postalCode": "10001",
-              "state": "NY",
-              "country": "US",
-              "nationalityCountry": "US",
-              "signInWallets": [
-                {
-                  "address": "0x1234567890abcdef1234567890abcdef12345678"
-                }
-              ],
-              "safeWallets": [
-                {
-                  "address": "0xabcdef1234567890abcdef1234567890abcdef12",
-                  "chainId": "100"
-                }
-              ],
-              "kycStatus": "approved",
-              "availableFeatures": {
-                "moneriumIban": true
-              },
-              "cards": [
-                {
-                  "id": "card_123",
-                  "cardToken": "card_token_456",
-                  "lastFourDigits": "1234",
-                  "embossedName": "John Doe",
-                  "activatedAt": "2024-01-15T10:30:00Z",
-                  "virtual": false
-                }
-              ],
-              "bankingDetails": {
-                "moneriumIban": "GB82WEST12345698765432",
-                "moneriumBic": "WESTGB22",
-                "moneriumIbanStatus": "ASSIGNED",
-                "address": "123 Main Street, New York, NY 10001"
-              },
-              "isSourceOfFundsAnswered": true,
-              "isPhoneValidated": true
-            }
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when a user's source of funds information changes.",
-        "example": {
-          "eventType": "kyc.source-of-funds.changed",
-          "data": {
-            "id": "user_123",
-            "email": "user@example.com",
-            "phone": "+1234567890",
-            "firstName": "John",
-            "lastName": "Doe",
-            "address1": "123 Main Street",
-            "address2": "Apt 4B",
-            "city": "New York",
-            "postalCode": "10001",
-            "state": "NY",
-            "country": "US",
-            "nationalityCountry": "US",
-            "signInWallets": [
-              {
-                "address": "0x1234567890abcdef1234567890abcdef12345678"
-              }
-            ],
-            "safeWallets": [
-              {
-                "address": "0xabcdef1234567890abcdef1234567890abcdef12",
-                "chainId": "100"
-              }
-            ],
-            "kycStatus": "approved",
-            "availableFeatures": {
-              "moneriumIban": true
-            },
-            "cards": [
-              {
-                "id": "card_123",
-                "cardToken": "card_token_456",
-                "lastFourDigits": "1234",
-                "embossedName": "John Doe",
-                "activatedAt": "2024-01-15T10:30:00Z",
-                "virtual": false
-              }
-            ],
-            "bankingDetails": {
-              "moneriumIban": "GB82WEST12345698765432",
-              "moneriumBic": "WESTGB22",
-              "moneriumIbanStatus": "ASSIGNED",
-              "address": "123 Main Street, New York, NY 10001"
-            },
-            "isSourceOfFundsAnswered": true,
-            "isPhoneValidated": true
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "kyc.source-of-funds.changed",
-  "data": {
-    "id": "user_123",
-    "email": "user@example.com",
-    "phone": "+1234567890",
-    "firstName": "John",
-    "lastName": "Doe",
-    "address1": "123 Main Street",
-    "address2": "Apt 4B",
-    "city": "New York",
-    "postalCode": "10001",
-    "state": "NY",
-    "country": "US",
-    "nationalityCountry": "US",
-    "signInWallets": [
-      {
-        "address": "0x1234567890abcdef1234567890abcdef12345678"
-      }
-    ],
-    "safeWallets": [
-      {
-        "address": "0xabcdef1234567890abcdef1234567890abcdef12",
-        "chainId": "100"
-      }
-    ],
-    "kycStatus": "approved",
-    "availableFeatures": {
-      "moneriumIban": true
-    },
-    "cards": [
-      {
-        "id": "card_123",
-        "cardToken": "card_token_456",
-        "lastFourDigits": "1234",
-        "embossedName": "John Doe",
-        "activatedAt": "2024-01-15T10:30:00Z",
-        "virtual": false
-      }
-    ],
-    "bankingDetails": {
-      "moneriumIban": "GB82WEST12345698765432",
-      "moneriumBic": "WESTGB22",
-      "moneriumIbanStatus": "ASSIGNED",
-      "address": "123 Main Street, New York, NY 10001"
-    },
-    "isSourceOfFundsAnswered": true,
-    "isPhoneValidated": true
-  }
-}
-```
-
-### kyc.status.changed
-
-Triggered when a user's KYC status changes.
-
-**Event Type**: `kyc.status.changed`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "kyc.status.changed";
-  data: {
-    /** Unique user identifier */
-    id: string;
-    /** User email address */
-    email: string;
-    /** User phone number */
-    phone: string;
-    /** User first name */
-    firstName: string;
-    /** User last name */
-    lastName: string;
-    /** Primary address line */
-    address1: string;
-    /** Secondary address line */
-    address2: string;
-    /** City */
-    city: string;
-    /** Postal/ZIP code */
-    postalCode: string;
-    /** State/Province */
-    state: string;
-    /** Country */
-    country: string;
-    /** Nationality country */
-    nationalityCountry: string;
-    /** User's sign-in wallet addresses */
-    signInWallets: {
-      /** Wallet address */
-      address: string;
-    }[];
-    /** User's safe wallet addresses */
-    safeWallets: {
-      /** Safe wallet address */
-      address: string;
-      /** Blockchain chain ID */
-      chainId: string;
-    }[];
-    /** KYC verification status */
-    kycStatus: "notStarted" | "documentsRequested" | "pending" | "processing" | "approved" | "resubmissionRequested" | "rejected" | "requiresAction";
-    /** Available features for the user */
-    availableFeatures: {
-      /** Whether Monerium IBAN is available */
-      moneriumIban: boolean;
-    };
-    /** User's cards */
-    cards: {
-      /** Card ID */
-      id: string;
-      /** Card token */
-      cardToken: string;
-      /** Last four digits of card */
-      lastFourDigits: string;
-      /** Name embossed on card */
-      embossedName: string;
-      /** Card activation timestamp */
-      activatedAt: string;
-      /** Whether card is virtual */
-      virtual: boolean;
-    }[];
-    /** User's banking details */
-    bankingDetails: {
-      /** Monerium IBAN */
-      moneriumIban: string;
-      /** Monerium BIC */
-      moneriumBic: string;
-      /** Monerium IBAN status */
-      moneriumIbanStatus: string;
-      /** Banking address */
-      address: string;
-    };
-    /** Whether source of funds question was answered */
-    isSourceOfFundsAnswered: boolean;
-    /** Whether phone number is validated */
-    isPhoneValidated: boolean;
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "kyc.status.changed Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when a user's KYC status changes."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "kyc.status.changed"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "id": {
-                "type": "string",
-                "description": "Unique user identifier"
-              },
-              "email": {
-                "type": "string",
-                "nullable": true,
-                "description": "User email address"
-              },
-              "phone": {
-                "type": "string",
-                "nullable": true,
-                "description": "User phone number"
-              },
-              "firstName": {
-                "type": "string",
-                "nullable": true,
-                "description": "User first name"
-              },
-              "lastName": {
-                "type": "string",
-                "nullable": true,
-                "description": "User last name"
-              },
-              "address1": {
-                "type": "string",
-                "nullable": true,
-                "description": "Primary address line"
-              },
-              "address2": {
-                "type": "string",
-                "nullable": true,
-                "description": "Secondary address line"
-              },
-              "city": {
-                "type": "string",
-                "nullable": true,
-                "description": "City"
-              },
-              "postalCode": {
-                "type": "string",
-                "nullable": true,
-                "description": "Postal/ZIP code"
-              },
-              "state": {
-                "type": "string",
-                "nullable": true,
-                "description": "State/Province"
-              },
-              "country": {
-                "type": "string",
-                "nullable": true,
-                "description": "Country"
-              },
-              "nationalityCountry": {
-                "type": "string",
-                "nullable": true,
-                "description": "Nationality country"
-              },
-              "signInWallets": {
-                "type": "array",
-                "items": {
-                  "type": "object",
-                  "properties": {
-                    "address": {
-                      "type": "string",
-                      "description": "Wallet address"
-                    }
-                  },
-                  "required": [
-                    "address"
-                  ]
-                },
-                "description": "User's sign-in wallet addresses"
-              },
-              "safeWallets": {
-                "type": "array",
-                "items": {
-                  "type": "object",
-                  "properties": {
-                    "address": {
-                      "type": "string",
-                      "description": "Safe wallet address"
-                    },
-                    "chainId": {
-                      "type": "string",
-                      "description": "Blockchain chain ID"
-                    }
-                  },
-                  "required": [
-                    "address",
-                    "chainId"
-                  ]
-                },
-                "description": "User's safe wallet addresses"
-              },
-              "kycStatus": {
-                "type": "string",
-                "enum": [
-                  "notStarted",
-                  "documentsRequested",
-                  "pending",
-                  "processing",
-                  "approved",
-                  "resubmissionRequested",
-                  "rejected",
-                  "requiresAction"
-                ],
-                "description": "KYC verification status",
-                "example": "approved"
-              },
-              "availableFeatures": {
-                "type": "object",
-                "properties": {
-                  "moneriumIban": {
-                    "type": "boolean",
-                    "description": "Whether Monerium IBAN is available"
-                  }
-                },
-                "required": [
-                  "moneriumIban"
-                ],
-                "description": "Available features for the user"
-              },
-              "cards": {
-                "type": "array",
-                "items": {
-                  "type": "object",
-                  "properties": {
-                    "id": {
-                      "type": "string",
-                      "description": "Card ID"
-                    },
-                    "cardToken": {
-                      "type": "string",
-                      "description": "Card token"
-                    },
-                    "lastFourDigits": {
-                      "type": "string",
-                      "description": "Last four digits of card"
-                    },
-                    "embossedName": {
-                      "type": "string",
-                      "nullable": true,
-                      "description": "Name embossed on card"
-                    },
-                    "activatedAt": {
-                      "type": "string",
-                      "nullable": true,
-                      "description": "Card activation timestamp"
-                    },
-                    "virtual": {
-                      "type": "boolean",
-                      "description": "Whether card is virtual"
-                    }
-                  },
-                  "required": [
-                    "id",
-                    "cardToken",
-                    "lastFourDigits",
-                    "embossedName",
-                    "activatedAt",
-                    "virtual"
-                  ]
-                },
-                "description": "User's cards"
-              },
-              "bankingDetails": {
-                "type": "object",
-                "nullable": true,
-                "properties": {
-                  "moneriumIban": {
-                    "type": "string",
-                    "nullable": true,
-                    "description": "Monerium IBAN"
-                  },
-                  "moneriumBic": {
-                    "type": "string",
-                    "nullable": true,
-                    "description": "Monerium BIC"
-                  },
-                  "moneriumIbanStatus": {
-                    "type": "string",
-                    "nullable": true,
-                    "description": "Monerium IBAN status"
-                  },
-                  "address": {
-                    "type": "string",
-                    "nullable": true,
-                    "description": "Banking address"
-                  }
-                },
-                "required": [
-                  "moneriumIban",
-                  "moneriumBic",
-                  "moneriumIbanStatus",
-                  "address"
-                ],
-                "description": "User's banking details"
-              },
-              "isSourceOfFundsAnswered": {
-                "type": "boolean",
-                "description": "Whether source of funds question was answered"
-              },
-              "isPhoneValidated": {
-                "type": "boolean",
-                "description": "Whether phone number is validated"
-              }
-            },
-            "required": [
-              "id",
-              "email",
-              "phone",
-              "firstName",
-              "lastName",
-              "address1",
-              "address2",
-              "city",
-              "postalCode",
-              "state",
-              "country",
-              "nationalityCountry",
-              "signInWallets",
-              "safeWallets",
-              "kycStatus",
-              "availableFeatures",
-              "cards",
-              "bankingDetails",
-              "isSourceOfFundsAnswered",
-              "isPhoneValidated"
-            ],
-            "description": "User data structure",
-            "example": {
-              "id": "user_123",
-              "email": "user@example.com",
-              "phone": "+1234567890",
-              "firstName": "John",
-              "lastName": "Doe",
-              "address1": "123 Main Street",
-              "address2": "Apt 4B",
-              "city": "New York",
-              "postalCode": "10001",
-              "state": "NY",
-              "country": "US",
-              "nationalityCountry": "US",
-              "signInWallets": [
-                {
-                  "address": "0x1234567890abcdef1234567890abcdef12345678"
-                }
-              ],
-              "safeWallets": [
-                {
-                  "address": "0xabcdef1234567890abcdef1234567890abcdef12",
-                  "chainId": "100"
-                }
-              ],
-              "kycStatus": "approved",
-              "availableFeatures": {
-                "moneriumIban": true
-              },
-              "cards": [
-                {
-                  "id": "card_123",
-                  "cardToken": "card_token_456",
-                  "lastFourDigits": "1234",
-                  "embossedName": "John Doe",
-                  "activatedAt": "2024-01-15T10:30:00Z",
-                  "virtual": false
-                }
-              ],
-              "bankingDetails": {
-                "moneriumIban": "GB82WEST12345698765432",
-                "moneriumBic": "WESTGB22",
-                "moneriumIbanStatus": "ASSIGNED",
-                "address": "123 Main Street, New York, NY 10001"
-              },
-              "isSourceOfFundsAnswered": true,
-              "isPhoneValidated": true
-            }
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when a user's KYC status changes.",
-        "example": {
-          "eventType": "kyc.status.changed",
-          "data": {
-            "id": "user_123",
-            "email": "user@example.com",
-            "phone": "+1234567890",
-            "firstName": "John",
-            "lastName": "Doe",
-            "address1": "123 Main Street",
-            "address2": "Apt 4B",
-            "city": "New York",
-            "postalCode": "10001",
-            "state": "NY",
-            "country": "US",
-            "nationalityCountry": "US",
-            "signInWallets": [
-              {
-                "address": "0x1234567890abcdef1234567890abcdef12345678"
-              }
-            ],
-            "safeWallets": [
-              {
-                "address": "0xabcdef1234567890abcdef1234567890abcdef12",
-                "chainId": "100"
-              }
-            ],
-            "kycStatus": "approved",
-            "availableFeatures": {
-              "moneriumIban": true
-            },
-            "cards": [
-              {
-                "id": "card_123",
-                "cardToken": "card_token_456",
-                "lastFourDigits": "1234",
-                "embossedName": "John Doe",
-                "activatedAt": "2024-01-15T10:30:00Z",
-                "virtual": false
-              }
-            ],
-            "bankingDetails": {
-              "moneriumIban": "GB82WEST12345698765432",
-              "moneriumBic": "WESTGB22",
-              "moneriumIbanStatus": "ASSIGNED",
-              "address": "123 Main Street, New York, NY 10001"
-            },
-            "isSourceOfFundsAnswered": true,
-            "isPhoneValidated": true
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "kyc.status.changed",
-  "data": {
-    "id": "user_123",
-    "email": "user@example.com",
-    "phone": "+1234567890",
-    "firstName": "John",
-    "lastName": "Doe",
-    "address1": "123 Main Street",
-    "address2": "Apt 4B",
-    "city": "New York",
-    "postalCode": "10001",
-    "state": "NY",
-    "country": "US",
-    "nationalityCountry": "US",
-    "signInWallets": [
-      {
-        "address": "0x1234567890abcdef1234567890abcdef12345678"
-      }
-    ],
-    "safeWallets": [
-      {
-        "address": "0xabcdef1234567890abcdef1234567890abcdef12",
-        "chainId": "100"
-      }
-    ],
-    "kycStatus": "approved",
-    "availableFeatures": {
-      "moneriumIban": true
-    },
-    "cards": [
-      {
-        "id": "card_123",
-        "cardToken": "card_token_456",
-        "lastFourDigits": "1234",
-        "embossedName": "John Doe",
-        "activatedAt": "2024-01-15T10:30:00Z",
-        "virtual": false
-      }
-    ],
-    "bankingDetails": {
-      "moneriumIban": "GB82WEST12345698765432",
-      "moneriumBic": "WESTGB22",
-      "moneriumIbanStatus": "ASSIGNED",
-      "address": "123 Main Street, New York, NY 10001"
-    },
-    "isSourceOfFundsAnswered": true,
-    "isPhoneValidated": true
-  }
-}
-```
-
-## User Lifecycle Events
-
-### user.created
-
-Triggered when a new user account is created in the Gnosis Pay system.
-
-**Event Type**: `user.created`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "user.created";
-  data: {
-    /** Unique user identifier */
-    id: string;
-    /** User email address */
-    email: string;
-    /** User phone number */
-    phone: string;
-    /** User first name */
-    firstName: string;
-    /** User last name */
-    lastName: string;
-    /** Primary address line */
-    address1: string;
-    /** Secondary address line */
-    address2: string;
-    /** City */
-    city: string;
-    /** Postal/ZIP code */
-    postalCode: string;
-    /** State/Province */
-    state: string;
-    /** Country */
-    country: string;
-    /** Nationality country */
-    nationalityCountry: string;
-    /** User's sign-in wallet addresses */
-    signInWallets: {
-      /** Wallet address */
-      address: string;
-    }[];
-    /** User's safe wallet addresses */
-    safeWallets: {
-      /** Safe wallet address */
-      address: string;
-      /** Blockchain chain ID */
-      chainId: string;
-    }[];
-    /** KYC verification status */
-    kycStatus: "notStarted" | "documentsRequested" | "pending" | "processing" | "approved" | "resubmissionRequested" | "rejected" | "requiresAction";
-    /** Available features for the user */
-    availableFeatures: {
-      /** Whether Monerium IBAN is available */
-      moneriumIban: boolean;
-    };
-    /** User's cards */
-    cards: {
-      /** Card ID */
-      id: string;
-      /** Card token */
-      cardToken: string;
-      /** Last four digits of card */
-      lastFourDigits: string;
-      /** Name embossed on card */
-      embossedName: string;
-      /** Card activation timestamp */
-      activatedAt: string;
-      /** Whether card is virtual */
-      virtual: boolean;
-    }[];
-    /** User's banking details */
-    bankingDetails: {
-      /** Monerium IBAN */
-      moneriumIban: string;
-      /** Monerium BIC */
-      moneriumBic: string;
-      /** Monerium IBAN status */
-      moneriumIbanStatus: string;
-      /** Banking address */
-      address: string;
-    };
-    /** Whether source of funds question was answered */
-    isSourceOfFundsAnswered: boolean;
-    /** Whether phone number is validated */
-    isPhoneValidated: boolean;
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "user.created Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when a new user account is created in the Gnosis Pay system."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "user.created"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "id": {
-                "type": "string",
-                "description": "Unique user identifier"
-              },
-              "email": {
-                "type": "string",
-                "nullable": true,
-                "description": "User email address"
-              },
-              "phone": {
-                "type": "string",
-                "nullable": true,
-                "description": "User phone number"
-              },
-              "firstName": {
-                "type": "string",
-                "nullable": true,
-                "description": "User first name"
-              },
-              "lastName": {
-                "type": "string",
-                "nullable": true,
-                "description": "User last name"
-              },
-              "address1": {
-                "type": "string",
-                "nullable": true,
-                "description": "Primary address line"
-              },
-              "address2": {
-                "type": "string",
-                "nullable": true,
-                "description": "Secondary address line"
-              },
-              "city": {
-                "type": "string",
-                "nullable": true,
-                "description": "City"
-              },
-              "postalCode": {
-                "type": "string",
-                "nullable": true,
-                "description": "Postal/ZIP code"
-              },
-              "state": {
-                "type": "string",
-                "nullable": true,
-                "description": "State/Province"
-              },
-              "country": {
-                "type": "string",
-                "nullable": true,
-                "description": "Country"
-              },
-              "nationalityCountry": {
-                "type": "string",
-                "nullable": true,
-                "description": "Nationality country"
-              },
-              "signInWallets": {
-                "type": "array",
-                "items": {
-                  "type": "object",
-                  "properties": {
-                    "address": {
-                      "type": "string",
-                      "description": "Wallet address"
-                    }
-                  },
-                  "required": [
-                    "address"
-                  ]
-                },
-                "description": "User's sign-in wallet addresses"
-              },
-              "safeWallets": {
-                "type": "array",
-                "items": {
-                  "type": "object",
-                  "properties": {
-                    "address": {
-                      "type": "string",
-                      "description": "Safe wallet address"
-                    },
-                    "chainId": {
-                      "type": "string",
-                      "description": "Blockchain chain ID"
-                    }
-                  },
-                  "required": [
-                    "address",
-                    "chainId"
-                  ]
-                },
-                "description": "User's safe wallet addresses"
-              },
-              "kycStatus": {
-                "type": "string",
-                "enum": [
-                  "notStarted",
-                  "documentsRequested",
-                  "pending",
-                  "processing",
-                  "approved",
-                  "resubmissionRequested",
-                  "rejected",
-                  "requiresAction"
-                ],
-                "description": "KYC verification status",
-                "example": "approved"
-              },
-              "availableFeatures": {
-                "type": "object",
-                "properties": {
-                  "moneriumIban": {
-                    "type": "boolean",
-                    "description": "Whether Monerium IBAN is available"
-                  }
-                },
-                "required": [
-                  "moneriumIban"
-                ],
-                "description": "Available features for the user"
-              },
-              "cards": {
-                "type": "array",
-                "items": {
-                  "type": "object",
-                  "properties": {
-                    "id": {
-                      "type": "string",
-                      "description": "Card ID"
-                    },
-                    "cardToken": {
-                      "type": "string",
-                      "description": "Card token"
-                    },
-                    "lastFourDigits": {
-                      "type": "string",
-                      "description": "Last four digits of card"
-                    },
-                    "embossedName": {
-                      "type": "string",
-                      "nullable": true,
-                      "description": "Name embossed on card"
-                    },
-                    "activatedAt": {
-                      "type": "string",
-                      "nullable": true,
-                      "description": "Card activation timestamp"
-                    },
-                    "virtual": {
-                      "type": "boolean",
-                      "description": "Whether card is virtual"
-                    }
-                  },
-                  "required": [
-                    "id",
-                    "cardToken",
-                    "lastFourDigits",
-                    "embossedName",
-                    "activatedAt",
-                    "virtual"
-                  ]
-                },
-                "description": "User's cards"
-              },
-              "bankingDetails": {
-                "type": "object",
-                "nullable": true,
-                "properties": {
-                  "moneriumIban": {
-                    "type": "string",
-                    "nullable": true,
-                    "description": "Monerium IBAN"
-                  },
-                  "moneriumBic": {
-                    "type": "string",
-                    "nullable": true,
-                    "description": "Monerium BIC"
-                  },
-                  "moneriumIbanStatus": {
-                    "type": "string",
-                    "nullable": true,
-                    "description": "Monerium IBAN status"
-                  },
-                  "address": {
-                    "type": "string",
-                    "nullable": true,
-                    "description": "Banking address"
-                  }
-                },
-                "required": [
-                  "moneriumIban",
-                  "moneriumBic",
-                  "moneriumIbanStatus",
-                  "address"
-                ],
-                "description": "User's banking details"
-              },
-              "isSourceOfFundsAnswered": {
-                "type": "boolean",
-                "description": "Whether source of funds question was answered"
-              },
-              "isPhoneValidated": {
-                "type": "boolean",
-                "description": "Whether phone number is validated"
-              }
-            },
-            "required": [
-              "id",
-              "email",
-              "phone",
-              "firstName",
-              "lastName",
-              "address1",
-              "address2",
-              "city",
-              "postalCode",
-              "state",
-              "country",
-              "nationalityCountry",
-              "signInWallets",
-              "safeWallets",
-              "kycStatus",
-              "availableFeatures",
-              "cards",
-              "bankingDetails",
-              "isSourceOfFundsAnswered",
-              "isPhoneValidated"
-            ],
-            "description": "User data structure",
-            "example": {
-              "id": "user_123",
-              "email": "user@example.com",
-              "phone": "+1234567890",
-              "firstName": "John",
-              "lastName": "Doe",
-              "address1": "123 Main Street",
-              "address2": "Apt 4B",
-              "city": "New York",
-              "postalCode": "10001",
-              "state": "NY",
-              "country": "US",
-              "nationalityCountry": "US",
-              "signInWallets": [
-                {
-                  "address": "0x1234567890abcdef1234567890abcdef12345678"
-                }
-              ],
-              "safeWallets": [
-                {
-                  "address": "0xabcdef1234567890abcdef1234567890abcdef12",
-                  "chainId": "100"
-                }
-              ],
-              "kycStatus": "approved",
-              "availableFeatures": {
-                "moneriumIban": true
-              },
-              "cards": [
-                {
-                  "id": "card_123",
-                  "cardToken": "card_token_456",
-                  "lastFourDigits": "1234",
-                  "embossedName": "John Doe",
-                  "activatedAt": "2024-01-15T10:30:00Z",
-                  "virtual": false
-                }
-              ],
-              "bankingDetails": {
-                "moneriumIban": "GB82WEST12345698765432",
-                "moneriumBic": "WESTGB22",
-                "moneriumIbanStatus": "ASSIGNED",
-                "address": "123 Main Street, New York, NY 10001"
-              },
-              "isSourceOfFundsAnswered": true,
-              "isPhoneValidated": true
-            }
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when a new user account is created in the Gnosis Pay system.",
-        "example": {
-          "eventType": "user.created",
-          "data": {
-            "id": "user_123",
-            "email": "user@example.com",
-            "phone": "+1234567890",
-            "firstName": "John",
-            "lastName": "Doe",
-            "address1": "123 Main Street",
-            "address2": "Apt 4B",
-            "city": "New York",
-            "postalCode": "10001",
-            "state": "NY",
-            "country": "US",
-            "nationalityCountry": "US",
-            "signInWallets": [
-              {
-                "address": "0x1234567890abcdef1234567890abcdef12345678"
-              }
-            ],
-            "safeWallets": [
-              {
-                "address": "0xabcdef1234567890abcdef1234567890abcdef12",
-                "chainId": "100"
-              }
-            ],
-            "kycStatus": "approved",
-            "availableFeatures": {
-              "moneriumIban": true
-            },
-            "cards": [
-              {
-                "id": "card_123",
-                "cardToken": "card_token_456",
-                "lastFourDigits": "1234",
-                "embossedName": "John Doe",
-                "activatedAt": "2024-01-15T10:30:00Z",
-                "virtual": false
-              }
-            ],
-            "bankingDetails": {
-              "moneriumIban": "GB82WEST12345698765432",
-              "moneriumBic": "WESTGB22",
-              "moneriumIbanStatus": "ASSIGNED",
-              "address": "123 Main Street, New York, NY 10001"
-            },
-            "isSourceOfFundsAnswered": true,
-            "isPhoneValidated": true
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "user.created",
-  "data": {
-    "id": "user_123",
-    "email": "user@example.com",
-    "phone": "+1234567890",
-    "firstName": "John",
-    "lastName": "Doe",
-    "address1": "123 Main Street",
-    "address2": "Apt 4B",
-    "city": "New York",
-    "postalCode": "10001",
-    "state": "NY",
-    "country": "US",
-    "nationalityCountry": "US",
-    "signInWallets": [
-      {
-        "address": "0x1234567890abcdef1234567890abcdef12345678"
-      }
-    ],
-    "safeWallets": [
-      {
-        "address": "0xabcdef1234567890abcdef1234567890abcdef12",
-        "chainId": "100"
-      }
-    ],
-    "kycStatus": "approved",
-    "availableFeatures": {
-      "moneriumIban": true
-    },
-    "cards": [
-      {
-        "id": "card_123",
-        "cardToken": "card_token_456",
-        "lastFourDigits": "1234",
-        "embossedName": "John Doe",
-        "activatedAt": "2024-01-15T10:30:00Z",
-        "virtual": false
-      }
-    ],
-    "bankingDetails": {
-      "moneriumIban": "GB82WEST12345698765432",
-      "moneriumBic": "WESTGB22",
-      "moneriumIbanStatus": "ASSIGNED",
-      "address": "123 Main Street, New York, NY 10001"
-    },
-    "isSourceOfFundsAnswered": true,
-    "isPhoneValidated": true
-  }
-}
-```
-
-### user.tos.accepted
-
-Triggered when a user accepts the Terms of Service.
-
-**Event Type**: `user.tos.accepted`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "user.tos.accepted";
-  data: {
-    /** Unique user identifier */
-    id: string;
-    /** User email address */
-    email: string;
-    /** User phone number */
-    phone: string;
-    /** User first name */
-    firstName: string;
-    /** User last name */
-    lastName: string;
-    /** Primary address line */
-    address1: string;
-    /** Secondary address line */
-    address2: string;
-    /** City */
-    city: string;
-    /** Postal/ZIP code */
-    postalCode: string;
-    /** State/Province */
-    state: string;
-    /** Country */
-    country: string;
-    /** Nationality country */
-    nationalityCountry: string;
-    /** User's sign-in wallet addresses */
-    signInWallets: {
-      /** Wallet address */
-      address: string;
-    }[];
-    /** User's safe wallet addresses */
-    safeWallets: {
-      /** Safe wallet address */
-      address: string;
-      /** Blockchain chain ID */
-      chainId: string;
-    }[];
-    /** KYC verification status */
-    kycStatus: "notStarted" | "documentsRequested" | "pending" | "processing" | "approved" | "resubmissionRequested" | "rejected" | "requiresAction";
-    /** Available features for the user */
-    availableFeatures: {
-      /** Whether Monerium IBAN is available */
-      moneriumIban: boolean;
-    };
-    /** User's cards */
-    cards: {
-      /** Card ID */
-      id: string;
-      /** Card token */
-      cardToken: string;
-      /** Last four digits of card */
-      lastFourDigits: string;
-      /** Name embossed on card */
-      embossedName: string;
-      /** Card activation timestamp */
-      activatedAt: string;
-      /** Whether card is virtual */
-      virtual: boolean;
-    }[];
-    /** User's banking details */
-    bankingDetails: {
-      /** Monerium IBAN */
-      moneriumIban: string;
-      /** Monerium BIC */
-      moneriumBic: string;
-      /** Monerium IBAN status */
-      moneriumIbanStatus: string;
-      /** Banking address */
-      address: string;
-    };
-    /** Whether source of funds question was answered */
-    isSourceOfFundsAnswered: boolean;
-    /** Whether phone number is validated */
-    isPhoneValidated: boolean;
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "user.tos.accepted Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when a user accepts the Terms of Service."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "user.tos.accepted"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "id": {
-                "type": "string",
-                "description": "Unique user identifier"
-              },
-              "email": {
-                "type": "string",
-                "nullable": true,
-                "description": "User email address"
-              },
-              "phone": {
-                "type": "string",
-                "nullable": true,
-                "description": "User phone number"
-              },
-              "firstName": {
-                "type": "string",
-                "nullable": true,
-                "description": "User first name"
-              },
-              "lastName": {
-                "type": "string",
-                "nullable": true,
-                "description": "User last name"
-              },
-              "address1": {
-                "type": "string",
-                "nullable": true,
-                "description": "Primary address line"
-              },
-              "address2": {
-                "type": "string",
-                "nullable": true,
-                "description": "Secondary address line"
-              },
-              "city": {
-                "type": "string",
-                "nullable": true,
-                "description": "City"
-              },
-              "postalCode": {
-                "type": "string",
-                "nullable": true,
-                "description": "Postal/ZIP code"
-              },
-              "state": {
-                "type": "string",
-                "nullable": true,
-                "description": "State/Province"
-              },
-              "country": {
-                "type": "string",
-                "nullable": true,
-                "description": "Country"
-              },
-              "nationalityCountry": {
-                "type": "string",
-                "nullable": true,
-                "description": "Nationality country"
-              },
-              "signInWallets": {
-                "type": "array",
-                "items": {
-                  "type": "object",
-                  "properties": {
-                    "address": {
-                      "type": "string",
-                      "description": "Wallet address"
-                    }
-                  },
-                  "required": [
-                    "address"
-                  ]
-                },
-                "description": "User's sign-in wallet addresses"
-              },
-              "safeWallets": {
-                "type": "array",
-                "items": {
-                  "type": "object",
-                  "properties": {
-                    "address": {
-                      "type": "string",
-                      "description": "Safe wallet address"
-                    },
-                    "chainId": {
-                      "type": "string",
-                      "description": "Blockchain chain ID"
-                    }
-                  },
-                  "required": [
-                    "address",
-                    "chainId"
-                  ]
-                },
-                "description": "User's safe wallet addresses"
-              },
-              "kycStatus": {
-                "type": "string",
-                "enum": [
-                  "notStarted",
-                  "documentsRequested",
-                  "pending",
-                  "processing",
-                  "approved",
-                  "resubmissionRequested",
-                  "rejected",
-                  "requiresAction"
-                ],
-                "description": "KYC verification status",
-                "example": "approved"
-              },
-              "availableFeatures": {
-                "type": "object",
-                "properties": {
-                  "moneriumIban": {
-                    "type": "boolean",
-                    "description": "Whether Monerium IBAN is available"
-                  }
-                },
-                "required": [
-                  "moneriumIban"
-                ],
-                "description": "Available features for the user"
-              },
-              "cards": {
-                "type": "array",
-                "items": {
-                  "type": "object",
-                  "properties": {
-                    "id": {
-                      "type": "string",
-                      "description": "Card ID"
-                    },
-                    "cardToken": {
-                      "type": "string",
-                      "description": "Card token"
-                    },
-                    "lastFourDigits": {
-                      "type": "string",
-                      "description": "Last four digits of card"
-                    },
-                    "embossedName": {
-                      "type": "string",
-                      "nullable": true,
-                      "description": "Name embossed on card"
-                    },
-                    "activatedAt": {
-                      "type": "string",
-                      "nullable": true,
-                      "description": "Card activation timestamp"
-                    },
-                    "virtual": {
-                      "type": "boolean",
-                      "description": "Whether card is virtual"
-                    }
-                  },
-                  "required": [
-                    "id",
-                    "cardToken",
-                    "lastFourDigits",
-                    "embossedName",
-                    "activatedAt",
-                    "virtual"
-                  ]
-                },
-                "description": "User's cards"
-              },
-              "bankingDetails": {
-                "type": "object",
-                "nullable": true,
-                "properties": {
-                  "moneriumIban": {
-                    "type": "string",
-                    "nullable": true,
-                    "description": "Monerium IBAN"
-                  },
-                  "moneriumBic": {
-                    "type": "string",
-                    "nullable": true,
-                    "description": "Monerium BIC"
-                  },
-                  "moneriumIbanStatus": {
-                    "type": "string",
-                    "nullable": true,
-                    "description": "Monerium IBAN status"
-                  },
-                  "address": {
-                    "type": "string",
-                    "nullable": true,
-                    "description": "Banking address"
-                  }
-                },
-                "required": [
-                  "moneriumIban",
-                  "moneriumBic",
-                  "moneriumIbanStatus",
-                  "address"
-                ],
-                "description": "User's banking details"
-              },
-              "isSourceOfFundsAnswered": {
-                "type": "boolean",
-                "description": "Whether source of funds question was answered"
-              },
-              "isPhoneValidated": {
-                "type": "boolean",
-                "description": "Whether phone number is validated"
-              }
-            },
-            "required": [
-              "id",
-              "email",
-              "phone",
-              "firstName",
-              "lastName",
-              "address1",
-              "address2",
-              "city",
-              "postalCode",
-              "state",
-              "country",
-              "nationalityCountry",
-              "signInWallets",
-              "safeWallets",
-              "kycStatus",
-              "availableFeatures",
-              "cards",
-              "bankingDetails",
-              "isSourceOfFundsAnswered",
-              "isPhoneValidated"
-            ],
-            "description": "User data structure",
-            "example": {
-              "id": "user_123",
-              "email": "user@example.com",
-              "phone": "+1234567890",
-              "firstName": "John",
-              "lastName": "Doe",
-              "address1": "123 Main Street",
-              "address2": "Apt 4B",
-              "city": "New York",
-              "postalCode": "10001",
-              "state": "NY",
-              "country": "US",
-              "nationalityCountry": "US",
-              "signInWallets": [
-                {
-                  "address": "0x1234567890abcdef1234567890abcdef12345678"
-                }
-              ],
-              "safeWallets": [
-                {
-                  "address": "0xabcdef1234567890abcdef1234567890abcdef12",
-                  "chainId": "100"
-                }
-              ],
-              "kycStatus": "approved",
-              "availableFeatures": {
-                "moneriumIban": true
-              },
-              "cards": [
-                {
-                  "id": "card_123",
-                  "cardToken": "card_token_456",
-                  "lastFourDigits": "1234",
-                  "embossedName": "John Doe",
-                  "activatedAt": "2024-01-15T10:30:00Z",
-                  "virtual": false
-                }
-              ],
-              "bankingDetails": {
-                "moneriumIban": "GB82WEST12345698765432",
-                "moneriumBic": "WESTGB22",
-                "moneriumIbanStatus": "ASSIGNED",
-                "address": "123 Main Street, New York, NY 10001"
-              },
-              "isSourceOfFundsAnswered": true,
-              "isPhoneValidated": true
-            }
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when a user accepts the Terms of Service.",
-        "example": {
-          "eventType": "user.tos.accepted",
-          "data": {
-            "id": "user_123",
-            "email": "user@example.com",
-            "phone": "+1234567890",
-            "firstName": "John",
-            "lastName": "Doe",
-            "address1": "123 Main Street",
-            "address2": "Apt 4B",
-            "city": "New York",
-            "postalCode": "10001",
-            "state": "NY",
-            "country": "US",
-            "nationalityCountry": "US",
-            "signInWallets": [
-              {
-                "address": "0x1234567890abcdef1234567890abcdef12345678"
-              }
-            ],
-            "safeWallets": [
-              {
-                "address": "0xabcdef1234567890abcdef1234567890abcdef12",
-                "chainId": "100"
-              }
-            ],
-            "kycStatus": "approved",
-            "availableFeatures": {
-              "moneriumIban": true
-            },
-            "cards": [
-              {
-                "id": "card_123",
-                "cardToken": "card_token_456",
-                "lastFourDigits": "1234",
-                "embossedName": "John Doe",
-                "activatedAt": "2024-01-15T10:30:00Z",
-                "virtual": false
-              }
-            ],
-            "bankingDetails": {
-              "moneriumIban": "GB82WEST12345698765432",
-              "moneriumBic": "WESTGB22",
-              "moneriumIbanStatus": "ASSIGNED",
-              "address": "123 Main Street, New York, NY 10001"
-            },
-            "isSourceOfFundsAnswered": true,
-            "isPhoneValidated": true
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "user.tos.accepted",
-  "data": {
-    "id": "user_123",
-    "email": "user@example.com",
-    "phone": "+1234567890",
-    "firstName": "John",
-    "lastName": "Doe",
-    "address1": "123 Main Street",
-    "address2": "Apt 4B",
-    "city": "New York",
-    "postalCode": "10001",
-    "state": "NY",
-    "country": "US",
-    "nationalityCountry": "US",
-    "signInWallets": [
-      {
-        "address": "0x1234567890abcdef1234567890abcdef12345678"
-      }
-    ],
-    "safeWallets": [
-      {
-        "address": "0xabcdef1234567890abcdef1234567890abcdef12",
-        "chainId": "100"
-      }
-    ],
-    "kycStatus": "approved",
-    "availableFeatures": {
-      "moneriumIban": true
-    },
-    "cards": [
-      {
-        "id": "card_123",
-        "cardToken": "card_token_456",
-        "lastFourDigits": "1234",
-        "embossedName": "John Doe",
-        "activatedAt": "2024-01-15T10:30:00Z",
-        "virtual": false
-      }
-    ],
-    "bankingDetails": {
-      "moneriumIban": "GB82WEST12345698765432",
-      "moneriumBic": "WESTGB22",
-      "moneriumIbanStatus": "ASSIGNED",
-      "address": "123 Main Street, New York, NY 10001"
-    },
-    "isSourceOfFundsAnswered": true,
-    "isPhoneValidated": true
-  }
-}
-```
-
-## Card Events
-
-### card.status.changed
-
-Triggered when a card's status changes.
-
-**Event Type**: `card.status.changed`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "card.status.changed";
-  data: {
-    /** User ID */
-    userId: string;
-    /** Card token */
-    cardToken: string;
-    /** Previous card status */
-    oldStatus: string;
-    /** New card status */
-    newStatus: string;
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "card.status.changed Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when a card's status changes."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "card.status.changed"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "userId": {
-                "type": "string",
-                "description": "User ID"
-              },
-              "cardToken": {
-                "type": "string",
-                "description": "Card token"
-              },
-              "oldStatus": {
-                "type": "string",
-                "description": "Previous card status"
-              },
-              "newStatus": {
-                "type": "string",
-                "description": "New card status"
-              }
-            },
-            "required": [
-              "userId",
-              "cardToken",
-              "oldStatus",
-              "newStatus"
-            ],
-            "description": "Card status change data",
-            "example": {
-              "userId": "user_123",
-              "cardToken": "card_123",
-              "oldStatus": "inactive",
-              "newStatus": "active"
-            }
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when a card's status changes.",
-        "example": {
-          "eventType": "card.status.changed",
-          "data": {
-            "userId": "user_123",
-            "cardToken": "card_123",
-            "oldStatus": "inactive",
-            "newStatus": "active"
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "card.status.changed",
-  "data": {
-    "userId": "user_123",
-    "cardToken": "card_123",
-    "oldStatus": "inactive",
-    "newStatus": "active"
-  }
-}
-```
-
-### card.transaction.cleared
-
-Triggered when a new card transaction is cleared.
-
-**Event Type**: `card.transaction.cleared`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "card.transaction.cleared";
-  data: {
-    /** User ID */
-    userId: string;
-    /** Card transaction event */
-    event: {
-      threadId: string;
-      createdAt: string;
-      clearedAt: string;
-      isPending: boolean;
-      country: {
-        name: string;
-        numeric: string;
-        alpha2: string;
-        alpha3: string;
-      };
-      mcc: string;
-      merchant: {
-        name: string;
-        city: string;
-        country?: {
-          name: string;
-          numeric: string;
-          alpha2: string;
-          alpha3: string;
-        };
-      };
-      billingAmount: string;
-      billingCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionAmount: string;
-      transactionCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionType: string;
-      cardToken: string;
-      impactsCashback: boolean | null;
-      transactions: {
-        status: "Unsubmitted" | "Unconfirmed" | "ExecReverted" | "ExecSuccess";
-        to: string;
-        value: string;
-        data: string;
-        hash: string | null;
-      }[];
-      kind: "Payment";
-      status: "Approved" | "IncorrectPin" | "InsufficientFunds" | "ExceedsApprovalAmountLimit" | "InvalidAmount" | "PinEntryTriesExceeded" | "IncorrectSecurityCode" | "Reversal" | "PartialReversal" | "Other";
-    } | {
-      threadId: string;
-      createdAt: string;
-      clearedAt: string;
-      isPending: boolean;
-      country: {
-        name: string;
-        numeric: string;
-        alpha2: string;
-        alpha3: string;
-      };
-      mcc: string;
-      merchant: {
-        name: string;
-        city: string;
-        country?: {
-          name: string;
-          numeric: string;
-          alpha2: string;
-          alpha3: string;
-        };
-      };
-      billingAmount: string;
-      billingCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionAmount: string;
-      transactionCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionType: string;
-      cardToken: string;
-      impactsCashback: boolean | null;
-      transactions: {
-        status: "Unsubmitted" | "Unconfirmed" | "ExecReverted" | "ExecSuccess";
-        to: string;
-        value: string;
-        data: string;
-        hash: string | null;
-      }[];
-      kind: "Refund";
-      refundAmount: string;
-      refundCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-    } | {
-      threadId: string;
-      createdAt: string;
-      clearedAt: string;
-      isPending: boolean;
-      country: {
-        name: string;
-        numeric: string;
-        alpha2: string;
-        alpha3: string;
-      };
-      mcc: string;
-      merchant: {
-        name: string;
-        city: string;
-        country?: {
-          name: string;
-          numeric: string;
-          alpha2: string;
-          alpha3: string;
-        };
-      };
-      billingAmount: string;
-      billingCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionAmount: string;
-      transactionCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionType: string;
-      cardToken: string;
-      impactsCashback: boolean | null;
-      transactions: {
-        status: "Unsubmitted" | "Unconfirmed" | "ExecReverted" | "ExecSuccess";
-        to: string;
-        value: string;
-        data: string;
-        hash: string | null;
-      }[];
-      kind: "Reversal";
-      reversalAmount: string;
-      reversalCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-    };
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "card.transaction.cleared Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when a new card transaction is cleared."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "card.transaction.cleared"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "userId": {
-                "type": "string",
-                "description": "User ID"
-              },
-              "event": {
-                "anyOf": [
-                  {
-                    "type": "object",
-                    "properties": {
-                      "threadId": {
-                        "type": "string"
-                      },
-                      "createdAt": {
-                        "type": "string"
-                      },
-                      "clearedAt": {
-                        "type": "string",
-                        "nullable": true
-                      },
-                      "isPending": {
-                        "type": "boolean"
-                      },
-                      "country": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "numeric": {
-                            "type": "string"
-                          },
-                          "alpha2": {
-                            "type": "string"
-                          },
-                          "alpha3": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "numeric",
-                          "alpha2",
-                          "alpha3"
-                        ]
-                      },
-                      "mcc": {
-                        "type": "string"
-                      },
-                      "merchant": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "city": {
-                            "type": "string"
-                          },
-                          "country": {
-                            "type": "object",
-                            "properties": {
-                              "name": {
-                                "type": "string"
-                              },
-                              "numeric": {
-                                "type": "string"
-                              },
-                              "alpha2": {
-                                "type": "string"
-                              },
-                              "alpha3": {
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "name",
-                              "numeric",
-                              "alpha2",
-                              "alpha3"
-                            ]
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "city"
-                        ]
-                      },
-                      "billingAmount": {
-                        "type": "string"
-                      },
-                      "billingCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionAmount": {
-                        "type": "string"
-                      },
-                      "transactionCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionType": {
-                        "type": "string"
-                      },
-                      "cardToken": {
-                        "type": "string"
-                      },
-                      "impactsCashback": {
-                        "type": "boolean",
-                        "nullable": true
-                      },
-                      "transactions": {
-                        "type": "array",
-                        "items": {
-                          "type": "object",
-                          "properties": {
-                            "status": {
-                              "type": "string",
-                              "enum": [
-                                "Unsubmitted",
-                                "Unconfirmed",
-                                "ExecReverted",
-                                "ExecSuccess"
-                              ]
-                            },
-                            "to": {
-                              "type": "string"
-                            },
-                            "value": {
-                              "type": "string"
-                            },
-                            "data": {
-                              "type": "string"
-                            },
-                            "hash": {
-                              "type": "string",
-                              "nullable": true
-                            }
-                          },
-                          "required": [
-                            "status",
-                            "to",
-                            "value",
-                            "data"
-                          ]
-                        }
-                      },
-                      "kind": {
-                        "type": "string",
-                        "enum": [
-                          "Payment"
-                        ]
-                      },
-                      "status": {
-                        "type": "string",
-                        "enum": [
-                          "Approved",
-                          "IncorrectPin",
-                          "InsufficientFunds",
-                          "ExceedsApprovalAmountLimit",
-                          "InvalidAmount",
-                          "PinEntryTriesExceeded",
-                          "IncorrectSecurityCode",
-                          "Reversal",
-                          "PartialReversal",
-                          "Other"
-                        ]
-                      }
-                    },
-                    "required": [
-                      "threadId",
-                      "createdAt",
-                      "clearedAt",
-                      "isPending",
-                      "country",
-                      "mcc",
-                      "merchant",
-                      "billingAmount",
-                      "billingCurrency",
-                      "transactionAmount",
-                      "transactionCurrency",
-                      "transactionType",
-                      "cardToken",
-                      "transactions",
-                      "kind",
-                      "status"
-                    ]
-                  },
-                  {
-                    "type": "object",
-                    "properties": {
-                      "threadId": {
-                        "type": "string"
-                      },
-                      "createdAt": {
-                        "type": "string"
-                      },
-                      "clearedAt": {
-                        "type": "string",
-                        "nullable": true
-                      },
-                      "isPending": {
-                        "type": "boolean"
-                      },
-                      "country": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "numeric": {
-                            "type": "string"
-                          },
-                          "alpha2": {
-                            "type": "string"
-                          },
-                          "alpha3": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "numeric",
-                          "alpha2",
-                          "alpha3"
-                        ]
-                      },
-                      "mcc": {
-                        "type": "string"
-                      },
-                      "merchant": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "city": {
-                            "type": "string"
-                          },
-                          "country": {
-                            "type": "object",
-                            "properties": {
-                              "name": {
-                                "type": "string"
-                              },
-                              "numeric": {
-                                "type": "string"
-                              },
-                              "alpha2": {
-                                "type": "string"
-                              },
-                              "alpha3": {
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "name",
-                              "numeric",
-                              "alpha2",
-                              "alpha3"
-                            ]
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "city"
-                        ]
-                      },
-                      "billingAmount": {
-                        "type": "string"
-                      },
-                      "billingCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionAmount": {
-                        "type": "string"
-                      },
-                      "transactionCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionType": {
-                        "type": "string"
-                      },
-                      "cardToken": {
-                        "type": "string"
-                      },
-                      "impactsCashback": {
-                        "type": "boolean",
-                        "nullable": true
-                      },
-                      "transactions": {
-                        "type": "array",
-                        "items": {
-                          "type": "object",
-                          "properties": {
-                            "status": {
-                              "type": "string",
-                              "enum": [
-                                "Unsubmitted",
-                                "Unconfirmed",
-                                "ExecReverted",
-                                "ExecSuccess"
-                              ]
-                            },
-                            "to": {
-                              "type": "string"
-                            },
-                            "value": {
-                              "type": "string"
-                            },
-                            "data": {
-                              "type": "string"
-                            },
-                            "hash": {
-                              "type": "string",
-                              "nullable": true
-                            }
-                          },
-                          "required": [
-                            "status",
-                            "to",
-                            "value",
-                            "data"
-                          ]
-                        }
-                      },
-                      "kind": {
-                        "type": "string",
-                        "enum": [
-                          "Refund"
-                        ]
-                      },
-                      "refundAmount": {
-                        "type": "string"
-                      },
-                      "refundCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      }
-                    },
-                    "required": [
-                      "threadId",
-                      "createdAt",
-                      "clearedAt",
-                      "isPending",
-                      "country",
-                      "mcc",
-                      "merchant",
-                      "billingAmount",
-                      "billingCurrency",
-                      "transactionAmount",
-                      "transactionCurrency",
-                      "transactionType",
-                      "cardToken",
-                      "transactions",
-                      "kind",
-                      "refundAmount",
-                      "refundCurrency"
-                    ]
-                  },
-                  {
-                    "type": "object",
-                    "properties": {
-                      "threadId": {
-                        "type": "string"
-                      },
-                      "createdAt": {
-                        "type": "string"
-                      },
-                      "clearedAt": {
-                        "type": "string",
-                        "nullable": true
-                      },
-                      "isPending": {
-                        "type": "boolean"
-                      },
-                      "country": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "numeric": {
-                            "type": "string"
-                          },
-                          "alpha2": {
-                            "type": "string"
-                          },
-                          "alpha3": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "numeric",
-                          "alpha2",
-                          "alpha3"
-                        ]
-                      },
-                      "mcc": {
-                        "type": "string"
-                      },
-                      "merchant": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "city": {
-                            "type": "string"
-                          },
-                          "country": {
-                            "type": "object",
-                            "properties": {
-                              "name": {
-                                "type": "string"
-                              },
-                              "numeric": {
-                                "type": "string"
-                              },
-                              "alpha2": {
-                                "type": "string"
-                              },
-                              "alpha3": {
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "name",
-                              "numeric",
-                              "alpha2",
-                              "alpha3"
-                            ]
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "city"
-                        ]
-                      },
-                      "billingAmount": {
-                        "type": "string"
-                      },
-                      "billingCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionAmount": {
-                        "type": "string"
-                      },
-                      "transactionCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionType": {
-                        "type": "string"
-                      },
-                      "cardToken": {
-                        "type": "string"
-                      },
-                      "impactsCashback": {
-                        "type": "boolean",
-                        "nullable": true
-                      },
-                      "transactions": {
-                        "type": "array",
-                        "items": {
-                          "type": "object",
-                          "properties": {
-                            "status": {
-                              "type": "string",
-                              "enum": [
-                                "Unsubmitted",
-                                "Unconfirmed",
-                                "ExecReverted",
-                                "ExecSuccess"
-                              ]
-                            },
-                            "to": {
-                              "type": "string"
-                            },
-                            "value": {
-                              "type": "string"
-                            },
-                            "data": {
-                              "type": "string"
-                            },
-                            "hash": {
-                              "type": "string",
-                              "nullable": true
-                            }
-                          },
-                          "required": [
-                            "status",
-                            "to",
-                            "value",
-                            "data"
-                          ]
-                        }
-                      },
-                      "kind": {
-                        "type": "string",
-                        "enum": [
-                          "Reversal"
-                        ]
-                      },
-                      "reversalAmount": {
-                        "type": "string"
-                      },
-                      "reversalCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      }
-                    },
-                    "required": [
-                      "threadId",
-                      "createdAt",
-                      "clearedAt",
-                      "isPending",
-                      "country",
-                      "mcc",
-                      "merchant",
-                      "billingAmount",
-                      "billingCurrency",
-                      "transactionAmount",
-                      "transactionCurrency",
-                      "transactionType",
-                      "cardToken",
-                      "transactions",
-                      "kind",
-                      "reversalAmount",
-                      "reversalCurrency"
-                    ]
-                  }
-                ],
-                "example": {
-                  "event": {
-                    "kind": "Payment",
-                    "threadId": "thread_123456789",
-                    "createdAt": "2024-01-15T10:30:00.000Z",
-                    "clearedAt": "2024-01-15T10:35:00.000Z",
-                    "isPending": false,
-                    "country": {
-                      "name": "United States",
-                      "numeric": "840",
-                      "alpha2": "US",
-                      "alpha3": "USA"
-                    },
-                    "mcc": "5411",
-                    "merchant": {
-                      "name": "Grocery Store Inc",
-                      "city": "New York",
-                      "country": {
-                        "name": "United States",
-                        "numeric": "840",
-                        "alpha2": "US",
-                        "alpha3": "USA"
-                      }
-                    },
-                    "billingAmount": "5000",
-                    "billingCurrency": {
-                      "symbol": "$",
-                      "code": "840",
-                      "decimals": 2,
-                      "name": "US Dollar"
-                    },
-                    "transactionAmount": "5000",
-                    "transactionCurrency": {
-                      "symbol": "$",
-                      "code": "840",
-                      "decimals": 2,
-                      "name": "US Dollar"
-                    },
-                    "transactionType": "purchase",
-                    "cardToken": "card_token_abc123",
-                    "impactsCashback": true,
-                    "status": "Approved",
-                    "transactions": [
-                      {
-                        "status": "ExecSuccess",
-                        "to": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
-                        "value": "5000000000000000000",
-                        "data": "0x",
-                        "hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
-                      }
-                    ]
-                  }
-                },
-                "description": "Card transaction event"
-              }
-            },
-            "required": [
-              "userId",
-              "event"
-            ]
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when a new card transaction is cleared.",
-        "example": {
-          "eventType": "card.transaction.cleared",
-          "data": {
-            "userId": "user_123",
-            "event": {
-              "kind": "Payment",
-              "threadId": "thread_123456789",
-              "createdAt": "2024-01-15T10:30:00.000Z",
-              "clearedAt": "2024-01-15T10:35:00.000Z",
-              "isPending": false,
-              "country": {
-                "name": "United States",
-                "numeric": "840",
-                "alpha2": "US",
-                "alpha3": "USA"
-              },
-              "mcc": "5411",
-              "merchant": {
-                "name": "Grocery Store Inc",
-                "city": "New York",
-                "country": {
-                  "name": "United States",
-                  "numeric": "840",
-                  "alpha2": "US",
-                  "alpha3": "USA"
-                }
-              },
-              "billingAmount": "5000",
-              "billingCurrency": {
-                "symbol": "$",
-                "code": "840",
-                "decimals": 2,
-                "name": "US Dollar"
-              },
-              "transactionAmount": "5000",
-              "transactionCurrency": {
-                "symbol": "$",
-                "code": "840",
-                "decimals": 2,
-                "name": "US Dollar"
-              },
-              "transactionType": "purchase",
-              "cardToken": "card_token_abc123",
-              "impactsCashback": true,
-              "status": "Approved",
-              "transactions": [
-                {
-                  "status": "ExecSuccess",
-                  "to": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
-                  "value": "5000000000000000000",
-                  "data": "0x",
-                  "hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
-                }
-              ]
-            }
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "card.transaction.cleared",
-  "data": {
-    "userId": "user_123",
-    "event": {
-      "kind": "Payment",
-      "threadId": "thread_123456789",
-      "createdAt": "2024-01-15T10:30:00.000Z",
-      "clearedAt": "2024-01-15T10:35:00.000Z",
-      "isPending": false,
-      "country": {
-        "name": "United States",
-        "numeric": "840",
-        "alpha2": "US",
-        "alpha3": "USA"
-      },
-      "mcc": "5411",
-      "merchant": {
-        "name": "Grocery Store Inc",
-        "city": "New York",
-        "country": {
-          "name": "United States",
-          "numeric": "840",
-          "alpha2": "US",
-          "alpha3": "USA"
-        }
-      },
-      "billingAmount": "5000",
-      "billingCurrency": {
-        "symbol": "$",
-        "code": "840",
-        "decimals": 2,
-        "name": "US Dollar"
-      },
-      "transactionAmount": "5000",
-      "transactionCurrency": {
-        "symbol": "$",
-        "code": "840",
-        "decimals": 2,
-        "name": "US Dollar"
-      },
-      "transactionType": "purchase",
-      "cardToken": "card_token_abc123",
-      "impactsCashback": true,
-      "status": "Approved",
-      "transactions": [
-        {
-          "status": "ExecSuccess",
-          "to": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
-          "value": "5000000000000000000",
-          "data": "0x",
-          "hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
-        }
-      ]
-    }
-  }
-}
-```
-
-### card.transaction.created
-
-Triggered when a new card transaction is created.
-
-**Event Type**: `card.transaction.created`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "card.transaction.created";
-  data: {
-    /** User ID */
-    userId: string;
-    /** Card transaction event */
-    event: {
-      threadId: string;
-      createdAt: string;
-      clearedAt: string;
-      isPending: boolean;
-      country: {
-        name: string;
-        numeric: string;
-        alpha2: string;
-        alpha3: string;
-      };
-      mcc: string;
-      merchant: {
-        name: string;
-        city: string;
-        country?: {
-          name: string;
-          numeric: string;
-          alpha2: string;
-          alpha3: string;
-        };
-      };
-      billingAmount: string;
-      billingCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionAmount: string;
-      transactionCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionType: string;
-      cardToken: string;
-      impactsCashback: boolean | null;
-      transactions: {
-        status: "Unsubmitted" | "Unconfirmed" | "ExecReverted" | "ExecSuccess";
-        to: string;
-        value: string;
-        data: string;
-        hash: string | null;
-      }[];
-      kind: "Payment";
-      status: "Approved" | "IncorrectPin" | "InsufficientFunds" | "ExceedsApprovalAmountLimit" | "InvalidAmount" | "PinEntryTriesExceeded" | "IncorrectSecurityCode" | "Reversal" | "PartialReversal" | "Other";
-    } | {
-      threadId: string;
-      createdAt: string;
-      clearedAt: string;
-      isPending: boolean;
-      country: {
-        name: string;
-        numeric: string;
-        alpha2: string;
-        alpha3: string;
-      };
-      mcc: string;
-      merchant: {
-        name: string;
-        city: string;
-        country?: {
-          name: string;
-          numeric: string;
-          alpha2: string;
-          alpha3: string;
-        };
-      };
-      billingAmount: string;
-      billingCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionAmount: string;
-      transactionCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionType: string;
-      cardToken: string;
-      impactsCashback: boolean | null;
-      transactions: {
-        status: "Unsubmitted" | "Unconfirmed" | "ExecReverted" | "ExecSuccess";
-        to: string;
-        value: string;
-        data: string;
-        hash: string | null;
-      }[];
-      kind: "Refund";
-      refundAmount: string;
-      refundCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-    } | {
-      threadId: string;
-      createdAt: string;
-      clearedAt: string;
-      isPending: boolean;
-      country: {
-        name: string;
-        numeric: string;
-        alpha2: string;
-        alpha3: string;
-      };
-      mcc: string;
-      merchant: {
-        name: string;
-        city: string;
-        country?: {
-          name: string;
-          numeric: string;
-          alpha2: string;
-          alpha3: string;
-        };
-      };
-      billingAmount: string;
-      billingCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionAmount: string;
-      transactionCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionType: string;
-      cardToken: string;
-      impactsCashback: boolean | null;
-      transactions: {
-        status: "Unsubmitted" | "Unconfirmed" | "ExecReverted" | "ExecSuccess";
-        to: string;
-        value: string;
-        data: string;
-        hash: string | null;
-      }[];
-      kind: "Reversal";
-      reversalAmount: string;
-      reversalCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-    };
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "card.transaction.created Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when a new card transaction is created."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "card.transaction.created"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "userId": {
-                "type": "string",
-                "description": "User ID"
-              },
-              "event": {
-                "anyOf": [
-                  {
-                    "type": "object",
-                    "properties": {
-                      "threadId": {
-                        "type": "string"
-                      },
-                      "createdAt": {
-                        "type": "string"
-                      },
-                      "clearedAt": {
-                        "type": "string",
-                        "nullable": true
-                      },
-                      "isPending": {
-                        "type": "boolean"
-                      },
-                      "country": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "numeric": {
-                            "type": "string"
-                          },
-                          "alpha2": {
-                            "type": "string"
-                          },
-                          "alpha3": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "numeric",
-                          "alpha2",
-                          "alpha3"
-                        ]
-                      },
-                      "mcc": {
-                        "type": "string"
-                      },
-                      "merchant": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "city": {
-                            "type": "string"
-                          },
-                          "country": {
-                            "type": "object",
-                            "properties": {
-                              "name": {
-                                "type": "string"
-                              },
-                              "numeric": {
-                                "type": "string"
-                              },
-                              "alpha2": {
-                                "type": "string"
-                              },
-                              "alpha3": {
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "name",
-                              "numeric",
-                              "alpha2",
-                              "alpha3"
-                            ]
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "city"
-                        ]
-                      },
-                      "billingAmount": {
-                        "type": "string"
-                      },
-                      "billingCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionAmount": {
-                        "type": "string"
-                      },
-                      "transactionCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionType": {
-                        "type": "string"
-                      },
-                      "cardToken": {
-                        "type": "string"
-                      },
-                      "impactsCashback": {
-                        "type": "boolean",
-                        "nullable": true
-                      },
-                      "transactions": {
-                        "type": "array",
-                        "items": {
-                          "type": "object",
-                          "properties": {
-                            "status": {
-                              "type": "string",
-                              "enum": [
-                                "Unsubmitted",
-                                "Unconfirmed",
-                                "ExecReverted",
-                                "ExecSuccess"
-                              ]
-                            },
-                            "to": {
-                              "type": "string"
-                            },
-                            "value": {
-                              "type": "string"
-                            },
-                            "data": {
-                              "type": "string"
-                            },
-                            "hash": {
-                              "type": "string",
-                              "nullable": true
-                            }
-                          },
-                          "required": [
-                            "status",
-                            "to",
-                            "value",
-                            "data"
-                          ]
-                        }
-                      },
-                      "kind": {
-                        "type": "string",
-                        "enum": [
-                          "Payment"
-                        ]
-                      },
-                      "status": {
-                        "type": "string",
-                        "enum": [
-                          "Approved",
-                          "IncorrectPin",
-                          "InsufficientFunds",
-                          "ExceedsApprovalAmountLimit",
-                          "InvalidAmount",
-                          "PinEntryTriesExceeded",
-                          "IncorrectSecurityCode",
-                          "Reversal",
-                          "PartialReversal",
-                          "Other"
-                        ]
-                      }
-                    },
-                    "required": [
-                      "threadId",
-                      "createdAt",
-                      "clearedAt",
-                      "isPending",
-                      "country",
-                      "mcc",
-                      "merchant",
-                      "billingAmount",
-                      "billingCurrency",
-                      "transactionAmount",
-                      "transactionCurrency",
-                      "transactionType",
-                      "cardToken",
-                      "transactions",
-                      "kind",
-                      "status"
-                    ]
-                  },
-                  {
-                    "type": "object",
-                    "properties": {
-                      "threadId": {
-                        "type": "string"
-                      },
-                      "createdAt": {
-                        "type": "string"
-                      },
-                      "clearedAt": {
-                        "type": "string",
-                        "nullable": true
-                      },
-                      "isPending": {
-                        "type": "boolean"
-                      },
-                      "country": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "numeric": {
-                            "type": "string"
-                          },
-                          "alpha2": {
-                            "type": "string"
-                          },
-                          "alpha3": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "numeric",
-                          "alpha2",
-                          "alpha3"
-                        ]
-                      },
-                      "mcc": {
-                        "type": "string"
-                      },
-                      "merchant": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "city": {
-                            "type": "string"
-                          },
-                          "country": {
-                            "type": "object",
-                            "properties": {
-                              "name": {
-                                "type": "string"
-                              },
-                              "numeric": {
-                                "type": "string"
-                              },
-                              "alpha2": {
-                                "type": "string"
-                              },
-                              "alpha3": {
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "name",
-                              "numeric",
-                              "alpha2",
-                              "alpha3"
-                            ]
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "city"
-                        ]
-                      },
-                      "billingAmount": {
-                        "type": "string"
-                      },
-                      "billingCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionAmount": {
-                        "type": "string"
-                      },
-                      "transactionCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionType": {
-                        "type": "string"
-                      },
-                      "cardToken": {
-                        "type": "string"
-                      },
-                      "impactsCashback": {
-                        "type": "boolean",
-                        "nullable": true
-                      },
-                      "transactions": {
-                        "type": "array",
-                        "items": {
-                          "type": "object",
-                          "properties": {
-                            "status": {
-                              "type": "string",
-                              "enum": [
-                                "Unsubmitted",
-                                "Unconfirmed",
-                                "ExecReverted",
-                                "ExecSuccess"
-                              ]
-                            },
-                            "to": {
-                              "type": "string"
-                            },
-                            "value": {
-                              "type": "string"
-                            },
-                            "data": {
-                              "type": "string"
-                            },
-                            "hash": {
-                              "type": "string",
-                              "nullable": true
-                            }
-                          },
-                          "required": [
-                            "status",
-                            "to",
-                            "value",
-                            "data"
-                          ]
-                        }
-                      },
-                      "kind": {
-                        "type": "string",
-                        "enum": [
-                          "Refund"
-                        ]
-                      },
-                      "refundAmount": {
-                        "type": "string"
-                      },
-                      "refundCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      }
-                    },
-                    "required": [
-                      "threadId",
-                      "createdAt",
-                      "clearedAt",
-                      "isPending",
-                      "country",
-                      "mcc",
-                      "merchant",
-                      "billingAmount",
-                      "billingCurrency",
-                      "transactionAmount",
-                      "transactionCurrency",
-                      "transactionType",
-                      "cardToken",
-                      "transactions",
-                      "kind",
-                      "refundAmount",
-                      "refundCurrency"
-                    ]
-                  },
-                  {
-                    "type": "object",
-                    "properties": {
-                      "threadId": {
-                        "type": "string"
-                      },
-                      "createdAt": {
-                        "type": "string"
-                      },
-                      "clearedAt": {
-                        "type": "string",
-                        "nullable": true
-                      },
-                      "isPending": {
-                        "type": "boolean"
-                      },
-                      "country": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "numeric": {
-                            "type": "string"
-                          },
-                          "alpha2": {
-                            "type": "string"
-                          },
-                          "alpha3": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "numeric",
-                          "alpha2",
-                          "alpha3"
-                        ]
-                      },
-                      "mcc": {
-                        "type": "string"
-                      },
-                      "merchant": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "city": {
-                            "type": "string"
-                          },
-                          "country": {
-                            "type": "object",
-                            "properties": {
-                              "name": {
-                                "type": "string"
-                              },
-                              "numeric": {
-                                "type": "string"
-                              },
-                              "alpha2": {
-                                "type": "string"
-                              },
-                              "alpha3": {
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "name",
-                              "numeric",
-                              "alpha2",
-                              "alpha3"
-                            ]
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "city"
-                        ]
-                      },
-                      "billingAmount": {
-                        "type": "string"
-                      },
-                      "billingCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionAmount": {
-                        "type": "string"
-                      },
-                      "transactionCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionType": {
-                        "type": "string"
-                      },
-                      "cardToken": {
-                        "type": "string"
-                      },
-                      "impactsCashback": {
-                        "type": "boolean",
-                        "nullable": true
-                      },
-                      "transactions": {
-                        "type": "array",
-                        "items": {
-                          "type": "object",
-                          "properties": {
-                            "status": {
-                              "type": "string",
-                              "enum": [
-                                "Unsubmitted",
-                                "Unconfirmed",
-                                "ExecReverted",
-                                "ExecSuccess"
-                              ]
-                            },
-                            "to": {
-                              "type": "string"
-                            },
-                            "value": {
-                              "type": "string"
-                            },
-                            "data": {
-                              "type": "string"
-                            },
-                            "hash": {
-                              "type": "string",
-                              "nullable": true
-                            }
-                          },
-                          "required": [
-                            "status",
-                            "to",
-                            "value",
-                            "data"
-                          ]
-                        }
-                      },
-                      "kind": {
-                        "type": "string",
-                        "enum": [
-                          "Reversal"
-                        ]
-                      },
-                      "reversalAmount": {
-                        "type": "string"
-                      },
-                      "reversalCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      }
-                    },
-                    "required": [
-                      "threadId",
-                      "createdAt",
-                      "clearedAt",
-                      "isPending",
-                      "country",
-                      "mcc",
-                      "merchant",
-                      "billingAmount",
-                      "billingCurrency",
-                      "transactionAmount",
-                      "transactionCurrency",
-                      "transactionType",
-                      "cardToken",
-                      "transactions",
-                      "kind",
-                      "reversalAmount",
-                      "reversalCurrency"
-                    ]
-                  }
-                ],
-                "example": {
-                  "event": {
-                    "kind": "Payment",
-                    "threadId": "thread_123456789",
-                    "createdAt": "2024-01-15T10:30:00.000Z",
-                    "clearedAt": "2024-01-15T10:35:00.000Z",
-                    "isPending": false,
-                    "country": {
-                      "name": "United States",
-                      "numeric": "840",
-                      "alpha2": "US",
-                      "alpha3": "USA"
-                    },
-                    "mcc": "5411",
-                    "merchant": {
-                      "name": "Grocery Store Inc",
-                      "city": "New York",
-                      "country": {
-                        "name": "United States",
-                        "numeric": "840",
-                        "alpha2": "US",
-                        "alpha3": "USA"
-                      }
-                    },
-                    "billingAmount": "5000",
-                    "billingCurrency": {
-                      "symbol": "$",
-                      "code": "840",
-                      "decimals": 2,
-                      "name": "US Dollar"
-                    },
-                    "transactionAmount": "5000",
-                    "transactionCurrency": {
-                      "symbol": "$",
-                      "code": "840",
-                      "decimals": 2,
-                      "name": "US Dollar"
-                    },
-                    "transactionType": "purchase",
-                    "cardToken": "card_token_abc123",
-                    "impactsCashback": true,
-                    "status": "Approved",
-                    "transactions": [
-                      {
-                        "status": "ExecSuccess",
-                        "to": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
-                        "value": "5000000000000000000",
-                        "data": "0x",
-                        "hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
-                      }
-                    ]
-                  }
-                },
-                "description": "Card transaction event"
-              }
-            },
-            "required": [
-              "userId",
-              "event"
-            ]
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when a new card transaction is created.",
-        "example": {
-          "eventType": "card.transaction.created",
-          "data": {
-            "userId": "user_123",
-            "event": {
-              "kind": "Payment",
-              "threadId": "thread_123456789",
-              "createdAt": "2024-01-15T10:30:00.000Z",
-              "clearedAt": "2024-01-15T10:35:00.000Z",
-              "isPending": false,
-              "country": {
-                "name": "United States",
-                "numeric": "840",
-                "alpha2": "US",
-                "alpha3": "USA"
-              },
-              "mcc": "5411",
-              "merchant": {
-                "name": "Grocery Store Inc",
-                "city": "New York",
-                "country": {
-                  "name": "United States",
-                  "numeric": "840",
-                  "alpha2": "US",
-                  "alpha3": "USA"
-                }
-              },
-              "billingAmount": "5000",
-              "billingCurrency": {
-                "symbol": "$",
-                "code": "840",
-                "decimals": 2,
-                "name": "US Dollar"
-              },
-              "transactionAmount": "5000",
-              "transactionCurrency": {
-                "symbol": "$",
-                "code": "840",
-                "decimals": 2,
-                "name": "US Dollar"
-              },
-              "transactionType": "purchase",
-              "cardToken": "card_token_abc123",
-              "impactsCashback": true,
-              "status": "Approved",
-              "transactions": [
-                {
-                  "status": "ExecSuccess",
-                  "to": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
-                  "value": "5000000000000000000",
-                  "data": "0x",
-                  "hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
-                }
-              ]
-            }
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "card.transaction.created",
-  "data": {
-    "userId": "user_123",
-    "event": {
-      "kind": "Payment",
-      "threadId": "thread_123456789",
-      "createdAt": "2024-01-15T10:30:00.000Z",
-      "clearedAt": "2024-01-15T10:35:00.000Z",
-      "isPending": false,
-      "country": {
-        "name": "United States",
-        "numeric": "840",
-        "alpha2": "US",
-        "alpha3": "USA"
-      },
-      "mcc": "5411",
-      "merchant": {
-        "name": "Grocery Store Inc",
-        "city": "New York",
-        "country": {
-          "name": "United States",
-          "numeric": "840",
-          "alpha2": "US",
-          "alpha3": "USA"
-        }
-      },
-      "billingAmount": "5000",
-      "billingCurrency": {
-        "symbol": "$",
-        "code": "840",
-        "decimals": 2,
-        "name": "US Dollar"
-      },
-      "transactionAmount": "5000",
-      "transactionCurrency": {
-        "symbol": "$",
-        "code": "840",
-        "decimals": 2,
-        "name": "US Dollar"
-      },
-      "transactionType": "purchase",
-      "cardToken": "card_token_abc123",
-      "impactsCashback": true,
-      "status": "Approved",
-      "transactions": [
-        {
-          "status": "ExecSuccess",
-          "to": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
-          "value": "5000000000000000000",
-          "data": "0x",
-          "hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
-        }
-      ]
-    }
-  }
-}
-```
-
-
-### card.transaction.confirmed
-
-Triggered when a blockchain transaction is confirmed.
-
-**Event Type**: `card.transaction.confirmed`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "card.transaction.confirmed";
-  data: {
-    /** User ID */
-    userId: string;
-    /** Card transaction event */
-    event: {
-      threadId: string;
-      createdAt: string;
-      clearedAt: string;
-      isPending: boolean;
-      country: {
-        name: string;
-        numeric: string;
-        alpha2: string;
-        alpha3: string;
-      };
-      mcc: string;
-      merchant: {
-        name: string;
-        city: string;
-        country?: {
-          name: string;
-          numeric: string;
-          alpha2: string;
-          alpha3: string;
-        };
-      };
-      billingAmount: string;
-      billingCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionAmount: string;
-      transactionCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionType: string;
-      cardToken: string;
-      impactsCashback: boolean | null;
-      transactions: {
-        status: "Unsubmitted" | "Unconfirmed" | "ExecReverted" | "ExecSuccess";
-        to: string;
-        value: string;
-        data: string;
-        hash: string | null;
-      }[];
-      kind: "Payment";
-      status: "Approved" | "IncorrectPin" | "InsufficientFunds" | "ExceedsApprovalAmountLimit" | "InvalidAmount" | "PinEntryTriesExceeded" | "IncorrectSecurityCode" | "Reversal" | "PartialReversal" | "Other";
-    } | {
-      threadId: string;
-      createdAt: string;
-      clearedAt: string;
-      isPending: boolean;
-      country: {
-        name: string;
-        numeric: string;
-        alpha2: string;
-        alpha3: string;
-      };
-      mcc: string;
-      merchant: {
-        name: string;
-        city: string;
-        country?: {
-          name: string;
-          numeric: string;
-          alpha2: string;
-          alpha3: string;
-        };
-      };
-      billingAmount: string;
-      billingCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionAmount: string;
-      transactionCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionType: string;
-      cardToken: string;
-      impactsCashback: boolean | null;
-      transactions: {
-        status: "Unsubmitted" | "Unconfirmed" | "ExecReverted" | "ExecSuccess";
-        to: string;
-        value: string;
-        data: string;
-        hash: string | null;
-      }[];
-      kind: "Refund";
-      refundAmount: string;
-      refundCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-    } | {
-      threadId: string;
-      createdAt: string;
-      clearedAt: string;
-      isPending: boolean;
-      country: {
-        name: string;
-        numeric: string;
-        alpha2: string;
-        alpha3: string;
-      };
-      mcc: string;
-      merchant: {
-        name: string;
-        city: string;
-        country?: {
-          name: string;
-          numeric: string;
-          alpha2: string;
-          alpha3: string;
-        };
-      };
-      billingAmount: string;
-      billingCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionAmount: string;
-      transactionCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionType: string;
-      cardToken: string;
-      impactsCashback: boolean | null;
-      transactions: {
-        status: "Unsubmitted" | "Unconfirmed" | "ExecReverted" | "ExecSuccess";
-        to: string;
-        value: string;
-        data: string;
-        hash: string | null;
-      }[];
-      kind: "Reversal";
-      reversalAmount: string;
-      reversalCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-    };
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "card.transaction.confirmed Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when the transaction hash becomes available after broadcast."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "card.transaction.confirmed"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "userId": {
-                "type": "string",
-                "description": "User ID"
-              },
-              "event": {
-                "anyOf": [
-                  {
-                    "type": "object",
-                    "properties": {
-                      "threadId": {
-                        "type": "string"
-                      },
-                      "createdAt": {
-                        "type": "string"
-                      },
-                      "clearedAt": {
-                        "type": "string",
-                        "nullable": true
-                      },
-                      "isPending": {
-                        "type": "boolean"
-                      },
-                      "country": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "numeric": {
-                            "type": "string"
-                          },
-                          "alpha2": {
-                            "type": "string"
-                          },
-                          "alpha3": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "numeric",
-                          "alpha2",
-                          "alpha3"
-                        ]
-                      },
-                      "mcc": {
-                        "type": "string"
-                      },
-                      "merchant": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "city": {
-                            "type": "string"
-                          },
-                          "country": {
-                            "type": "object",
-                            "properties": {
-                              "name": {
-                                "type": "string"
-                              },
-                              "numeric": {
-                                "type": "string"
-                              },
-                              "alpha2": {
-                                "type": "string"
-                              },
-                              "alpha3": {
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "name",
-                              "numeric",
-                              "alpha2",
-                              "alpha3"
-                            ]
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "city"
-                        ]
-                      },
-                      "billingAmount": {
-                        "type": "string"
-                      },
-                      "billingCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionAmount": {
-                        "type": "string"
-                      },
-                      "transactionCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionType": {
-                        "type": "string"
-                      },
-                      "cardToken": {
-                        "type": "string"
-                      },
-                      "impactsCashback": {
-                        "type": "boolean",
-                        "nullable": true
-                      },
-                      "transactions": {
-                        "type": "array",
-                        "items": {
-                          "type": "object",
-                          "properties": {
-                            "status": {
-                              "type": "string",
-                              "enum": [
-                                "Unsubmitted",
-                                "Unconfirmed",
-                                "ExecReverted",
-                                "ExecSuccess"
-                              ]
-                            },
-                            "to": {
-                              "type": "string"
-                            },
-                            "value": {
-                              "type": "string"
-                            },
-                            "data": {
-                              "type": "string"
-                            },
-                            "hash": {
-                              "type": "string",
-                              "nullable": true
-                            }
-                          },
-                          "required": [
-                            "status",
-                            "to",
-                            "value",
-                            "data"
-                          ]
-                        }
-                      },
-                      "kind": {
-                        "type": "string",
-                        "enum": [
-                          "Payment"
-                        ]
-                      },
-                      "status": {
-                        "type": "string",
-                        "enum": [
-                          "Approved",
-                          "IncorrectPin",
-                          "InsufficientFunds",
-                          "ExceedsApprovalAmountLimit",
-                          "InvalidAmount",
-                          "PinEntryTriesExceeded",
-                          "IncorrectSecurityCode",
-                          "Reversal",
-                          "PartialReversal",
-                          "Other"
-                        ]
-                      }
-                    },
-                    "required": [
-                      "threadId",
-                      "createdAt",
-                      "clearedAt",
-                      "isPending",
-                      "country",
-                      "mcc",
-                      "merchant",
-                      "billingAmount",
-                      "billingCurrency",
-                      "transactionAmount",
-                      "transactionCurrency",
-                      "transactionType",
-                      "cardToken",
-                      "transactions",
-                      "kind",
-                      "status"
-                    ]
-                  },
-                  {
-                    "type": "object",
-                    "properties": {
-                      "threadId": {
-                        "type": "string"
-                      },
-                      "createdAt": {
-                        "type": "string"
-                      },
-                      "clearedAt": {
-                        "type": "string",
-                        "nullable": true
-                      },
-                      "isPending": {
-                        "type": "boolean"
-                      },
-                      "country": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "numeric": {
-                            "type": "string"
-                          },
-                          "alpha2": {
-                            "type": "string"
-                          },
-                          "alpha3": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "numeric",
-                          "alpha2",
-                          "alpha3"
-                        ]
-                      },
-                      "mcc": {
-                        "type": "string"
-                      },
-                      "merchant": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "city": {
-                            "type": "string"
-                          },
-                          "country": {
-                            "type": "object",
-                            "properties": {
-                              "name": {
-                                "type": "string"
-                              },
-                              "numeric": {
-                                "type": "string"
-                              },
-                              "alpha2": {
-                                "type": "string"
-                              },
-                              "alpha3": {
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "name",
-                              "numeric",
-                              "alpha2",
-                              "alpha3"
-                            ]
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "city"
-                        ]
-                      },
-                      "billingAmount": {
-                        "type": "string"
-                      },
-                      "billingCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionAmount": {
-                        "type": "string"
-                      },
-                      "transactionCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionType": {
-                        "type": "string"
-                      },
-                      "cardToken": {
-                        "type": "string"
-                      },
-                      "impactsCashback": {
-                        "type": "boolean",
-                        "nullable": true
-                      },
-                      "transactions": {
-                        "type": "array",
-                        "items": {
-                          "type": "object",
-                          "properties": {
-                            "status": {
-                              "type": "string",
-                              "enum": [
-                                "Unsubmitted",
-                                "Unconfirmed",
-                                "ExecReverted",
-                                "ExecSuccess"
-                              ]
-                            },
-                            "to": {
-                              "type": "string"
-                            },
-                            "value": {
-                              "type": "string"
-                            },
-                            "data": {
-                              "type": "string"
-                            },
-                            "hash": {
-                              "type": "string",
-                              "nullable": true
-                            }
-                          },
-                          "required": [
-                            "status",
-                            "to",
-                            "value",
-                            "data"
-                          ]
-                        }
-                      },
-                      "kind": {
-                        "type": "string",
-                        "enum": [
-                          "Refund"
-                        ]
-                      },
-                      "refundAmount": {
-                        "type": "string"
-                      },
-                      "refundCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      }
-                    },
-                    "required": [
-                      "threadId",
-                      "createdAt",
-                      "clearedAt",
-                      "isPending",
-                      "country",
-                      "mcc",
-                      "merchant",
-                      "billingAmount",
-                      "billingCurrency",
-                      "transactionAmount",
-                      "transactionCurrency",
-                      "transactionType",
-                      "cardToken",
-                      "transactions",
-                      "kind",
-                      "refundAmount",
-                      "refundCurrency"
-                    ]
-                  },
-                  {
-                    "type": "object",
-                    "properties": {
-                      "threadId": {
-                        "type": "string"
-                      },
-                      "createdAt": {
-                        "type": "string"
-                      },
-                      "clearedAt": {
-                        "type": "string",
-                        "nullable": true
-                      },
-                      "isPending": {
-                        "type": "boolean"
-                      },
-                      "country": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "numeric": {
-                            "type": "string"
-                          },
-                          "alpha2": {
-                            "type": "string"
-                          },
-                          "alpha3": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "numeric",
-                          "alpha2",
-                          "alpha3"
-                        ]
-                      },
-                      "mcc": {
-                        "type": "string"
-                      },
-                      "merchant": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "city": {
-                            "type": "string"
-                          },
-                          "country": {
-                            "type": "object",
-                            "properties": {
-                              "name": {
-                                "type": "string"
-                              },
-                              "numeric": {
-                                "type": "string"
-                              },
-                              "alpha2": {
-                                "type": "string"
-                              },
-                              "alpha3": {
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "name",
-                              "numeric",
-                              "alpha2",
-                              "alpha3"
-                            ]
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "city"
-                        ]
-                      },
-                      "billingAmount": {
-                        "type": "string"
-                      },
-                      "billingCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionAmount": {
-                        "type": "string"
-                      },
-                      "transactionCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionType": {
-                        "type": "string"
-                      },
-                      "cardToken": {
-                        "type": "string"
-                      },
-                      "impactsCashback": {
-                        "type": "boolean",
-                        "nullable": true
-                      },
-                      "transactions": {
-                        "type": "array",
-                        "items": {
-                          "type": "object",
-                          "properties": {
-                            "status": {
-                              "type": "string",
-                              "enum": [
-                                "Unsubmitted",
-                                "Unconfirmed",
-                                "ExecReverted",
-                                "ExecSuccess"
-                              ]
-                            },
-                            "to": {
-                              "type": "string"
-                            },
-                            "value": {
-                              "type": "string"
-                            },
-                            "data": {
-                              "type": "string"
-                            },
-                            "hash": {
-                              "type": "string",
-                              "nullable": true
-                            }
-                          },
-                          "required": [
-                            "status",
-                            "to",
-                            "value",
-                            "data"
-                          ]
-                        }
-                      },
-                      "kind": {
-                        "type": "string",
-                        "enum": [
-                          "Reversal"
-                        ]
-                      },
-                      "reversalAmount": {
-                        "type": "string"
-                      },
-                      "reversalCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      }
-                    },
-                    "required": [
-                      "threadId",
-                      "createdAt",
-                      "clearedAt",
-                      "isPending",
-                      "country",
-                      "mcc",
-                      "merchant",
-                      "billingAmount",
-                      "billingCurrency",
-                      "transactionAmount",
-                      "transactionCurrency",
-                      "transactionType",
-                      "cardToken",
-                      "transactions",
-                      "kind",
-                      "reversalAmount",
-                      "reversalCurrency"
-                    ]
-                  }
-                ],
-                "example": {
-                  "event": {
-                    "kind": "Payment",
-                    "threadId": "thread_123456789",
-                    "createdAt": "2024-01-15T10:30:00.000Z",
-                    "clearedAt": "2024-01-15T10:35:00.000Z",
-                    "isPending": false,
-                    "country": {
-                      "name": "United States",
-                      "numeric": "840",
-                      "alpha2": "US",
-                      "alpha3": "USA"
-                    },
-                    "mcc": "5411",
-                    "merchant": {
-                      "name": "Grocery Store Inc",
-                      "city": "New York",
-                      "country": {
-                        "name": "United States",
-                        "numeric": "840",
-                        "alpha2": "US",
-                        "alpha3": "USA"
-                      }
-                    },
-                    "billingAmount": "5000",
-                    "billingCurrency": {
-                      "symbol": "$",
-                      "code": "840",
-                      "decimals": 2,
-                      "name": "US Dollar"
-                    },
-                    "transactionAmount": "5000",
-                    "transactionCurrency": {
-                      "symbol": "$",
-                      "code": "840",
-                      "decimals": 2,
-                      "name": "US Dollar"
-                    },
-                    "transactionType": "purchase",
-                    "cardToken": "card_token_abc123",
-                    "impactsCashback": true,
-                    "status": "Approved",
-                    "transactions": [
-                      {
-                        "status": "ExecSuccess",
-                        "to": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
-                        "value": "5000000000000000000",
-                        "data": "0x",
-                        "hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
-                      }
-                    ]
-                  }
-                },
-                "description": "Card transaction event"
-              }
-            },
-            "required": [
-              "userId",
-              "event"
-            ]
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when the transaction hash becomes available after broadcast.",
-        "example": {
-          "eventType": "card.transaction.confirmed",
-          "data": {
-            "userId": "user_123",
-            "event": {
-              "kind": "Payment",
-              "threadId": "thread_123456789",
-              "createdAt": "2024-01-15T10:30:00.000Z",
-              "clearedAt": "2024-01-15T10:35:00.000Z",
-              "isPending": false,
-              "country": {
-                "name": "United States",
-                "numeric": "840",
-                "alpha2": "US",
-                "alpha3": "USA"
-              },
-              "mcc": "5411",
-              "merchant": {
-                "name": "Grocery Store Inc",
-                "city": "New York",
-                "country": {
-                  "name": "United States",
-                  "numeric": "840",
-                  "alpha2": "US",
-                  "alpha3": "USA"
-                }
-              },
-              "billingAmount": "5000",
-              "billingCurrency": {
-                "symbol": "$",
-                "code": "840",
-                "decimals": 2,
-                "name": "US Dollar"
-              },
-              "transactionAmount": "5000",
-              "transactionCurrency": {
-                "symbol": "$",
-                "code": "840",
-                "decimals": 2,
-                "name": "US Dollar"
-              },
-              "transactionType": "purchase",
-              "cardToken": "card_token_abc123",
-              "impactsCashback": true,
-              "status": "Approved",
-              "transactions": [
-                {
-                  "status": "ExecSuccess",
-                  "to": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
-                  "value": "5000000000000000000",
-                  "data": "0x",
-                  "hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
-                }
-              ]
-            }
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "card.transaction.confirmed",
-  "data": {
-    "userId": "user_123",
-    "event": {
-      "kind": "Payment",
-      "threadId": "thread_123456789",
-      "createdAt": "2024-01-15T10:30:00.000Z",
-      "clearedAt": "2024-01-15T10:35:00.000Z",
-      "isPending": false,
-      "country": {
-        "name": "United States",
-        "numeric": "840",
-        "alpha2": "US",
-        "alpha3": "USA"
-      },
-      "mcc": "5411",
-      "merchant": {
-        "name": "Grocery Store Inc",
-        "city": "New York",
-        "country": {
-          "name": "United States",
-          "numeric": "840",
-          "alpha2": "US",
-          "alpha3": "USA"
-        }
-      },
-      "billingAmount": "5000",
-      "billingCurrency": {
-        "symbol": "$",
-        "code": "840",
-        "decimals": 2,
-        "name": "US Dollar"
-      },
-      "transactionAmount": "5000",
-      "transactionCurrency": {
-        "symbol": "$",
-        "code": "840",
-        "decimals": 2,
-        "name": "US Dollar"
-      },
-      "transactionType": "purchase",
-      "cardToken": "card_token_abc123",
-      "impactsCashback": true,
-      "status": "Approved",
-      "transactions": [
-        {
-          "status": "ExecSuccess",
-          "to": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
-          "value": "5000000000000000000",
-          "data": "0x",
-          "hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
-        }
-      ]
-    }
-  }
-}
-```
-
-### card.transaction.failed
-
-Triggered when a blockchain transaction fails.
-
-**Event Type**: `card.transaction.failed`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "card.transaction.failed";
-  data: {
-    /** User ID */
-    userId: string;
-    /** Card transaction event */
-    event: {
-      threadId: string;
-      createdAt: string;
-      clearedAt: string;
-      isPending: boolean;
-      country: {
-        name: string;
-        numeric: string;
-        alpha2: string;
-        alpha3: string;
-      };
-      mcc: string;
-      merchant: {
-        name: string;
-        city: string;
-        country?: {
-          name: string;
-          numeric: string;
-          alpha2: string;
-          alpha3: string;
-        };
-      };
-      billingAmount: string;
-      billingCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionAmount: string;
-      transactionCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionType: string;
-      cardToken: string;
-      impactsCashback: boolean | null;
-      transactions: {
-        status: "Unsubmitted" | "Unconfirmed" | "ExecReverted" | "ExecSuccess";
-        to: string;
-        value: string;
-        data: string;
-        hash: string | null;
-      }[];
-      kind: "Payment";
-      status: "Approved" | "IncorrectPin" | "InsufficientFunds" | "ExceedsApprovalAmountLimit" | "InvalidAmount" | "PinEntryTriesExceeded" | "IncorrectSecurityCode" | "Reversal" | "PartialReversal" | "Other";
-    } | {
-      threadId: string;
-      createdAt: string;
-      clearedAt: string;
-      isPending: boolean;
-      country: {
-        name: string;
-        numeric: string;
-        alpha2: string;
-        alpha3: string;
-      };
-      mcc: string;
-      merchant: {
-        name: string;
-        city: string;
-        country?: {
-          name: string;
-          numeric: string;
-          alpha2: string;
-          alpha3: string;
-        };
-      };
-      billingAmount: string;
-      billingCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionAmount: string;
-      transactionCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionType: string;
-      cardToken: string;
-      impactsCashback: boolean | null;
-      transactions: {
-        status: "Unsubmitted" | "Unconfirmed" | "ExecReverted" | "ExecSuccess";
-        to: string;
-        value: string;
-        data: string;
-        hash: string | null;
-      }[];
-      kind: "Refund";
-      refundAmount: string;
-      refundCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-    } | {
-      threadId: string;
-      createdAt: string;
-      clearedAt: string;
-      isPending: boolean;
-      country: {
-        name: string;
-        numeric: string;
-        alpha2: string;
-        alpha3: string;
-      };
-      mcc: string;
-      merchant: {
-        name: string;
-        city: string;
-        country?: {
-          name: string;
-          numeric: string;
-          alpha2: string;
-          alpha3: string;
-        };
-      };
-      billingAmount: string;
-      billingCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionAmount: string;
-      transactionCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionType: string;
-      cardToken: string;
-      impactsCashback: boolean | null;
-      transactions: {
-        status: "Unsubmitted" | "Unconfirmed" | "ExecReverted" | "ExecSuccess";
-        to: string;
-        value: string;
-        data: string;
-        hash: string | null;
-      }[];
-      kind: "Reversal";
-      reversalAmount: string;
-      reversalCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-    };
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "card.transaction.failed Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when the transaction hash becomes available after broadcast."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "card.transaction.failed"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "userId": {
-                "type": "string",
-                "description": "User ID"
-              },
-              "event": {
-                "anyOf": [
-                  {
-                    "type": "object",
-                    "properties": {
-                      "threadId": {
-                        "type": "string"
-                      },
-                      "createdAt": {
-                        "type": "string"
-                      },
-                      "clearedAt": {
-                        "type": "string",
-                        "nullable": true
-                      },
-                      "isPending": {
-                        "type": "boolean"
-                      },
-                      "country": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "numeric": {
-                            "type": "string"
-                          },
-                          "alpha2": {
-                            "type": "string"
-                          },
-                          "alpha3": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "numeric",
-                          "alpha2",
-                          "alpha3"
-                        ]
-                      },
-                      "mcc": {
-                        "type": "string"
-                      },
-                      "merchant": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "city": {
-                            "type": "string"
-                          },
-                          "country": {
-                            "type": "object",
-                            "properties": {
-                              "name": {
-                                "type": "string"
-                              },
-                              "numeric": {
-                                "type": "string"
-                              },
-                              "alpha2": {
-                                "type": "string"
-                              },
-                              "alpha3": {
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "name",
-                              "numeric",
-                              "alpha2",
-                              "alpha3"
-                            ]
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "city"
-                        ]
-                      },
-                      "billingAmount": {
-                        "type": "string"
-                      },
-                      "billingCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionAmount": {
-                        "type": "string"
-                      },
-                      "transactionCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionType": {
-                        "type": "string"
-                      },
-                      "cardToken": {
-                        "type": "string"
-                      },
-                      "impactsCashback": {
-                        "type": "boolean",
-                        "nullable": true
-                      },
-                      "transactions": {
-                        "type": "array",
-                        "items": {
-                          "type": "object",
-                          "properties": {
-                            "status": {
-                              "type": "string",
-                              "enum": [
-                                "Unsubmitted",
-                                "Unconfirmed",
-                                "ExecReverted",
-                                "ExecSuccess"
-                              ]
-                            },
-                            "to": {
-                              "type": "string"
-                            },
-                            "value": {
-                              "type": "string"
-                            },
-                            "data": {
-                              "type": "string"
-                            },
-                            "hash": {
-                              "type": "string",
-                              "nullable": true
-                            }
-                          },
-                          "required": [
-                            "status",
-                            "to",
-                            "value",
-                            "data"
-                          ]
-                        }
-                      },
-                      "kind": {
-                        "type": "string",
-                        "enum": [
-                          "Payment"
-                        ]
-                      },
-                      "status": {
-                        "type": "string",
-                        "enum": [
-                          "Approved",
-                          "IncorrectPin",
-                          "InsufficientFunds",
-                          "ExceedsApprovalAmountLimit",
-                          "InvalidAmount",
-                          "PinEntryTriesExceeded",
-                          "IncorrectSecurityCode",
-                          "Reversal",
-                          "PartialReversal",
-                          "Other"
-                        ]
-                      }
-                    },
-                    "required": [
-                      "threadId",
-                      "createdAt",
-                      "clearedAt",
-                      "isPending",
-                      "country",
-                      "mcc",
-                      "merchant",
-                      "billingAmount",
-                      "billingCurrency",
-                      "transactionAmount",
-                      "transactionCurrency",
-                      "transactionType",
-                      "cardToken",
-                      "transactions",
-                      "kind",
-                      "status"
-                    ]
-                  },
-                  {
-                    "type": "object",
-                    "properties": {
-                      "threadId": {
-                        "type": "string"
-                      },
-                      "createdAt": {
-                        "type": "string"
-                      },
-                      "clearedAt": {
-                        "type": "string",
-                        "nullable": true
-                      },
-                      "isPending": {
-                        "type": "boolean"
-                      },
-                      "country": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "numeric": {
-                            "type": "string"
-                          },
-                          "alpha2": {
-                            "type": "string"
-                          },
-                          "alpha3": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "numeric",
-                          "alpha2",
-                          "alpha3"
-                        ]
-                      },
-                      "mcc": {
-                        "type": "string"
-                      },
-                      "merchant": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "city": {
-                            "type": "string"
-                          },
-                          "country": {
-                            "type": "object",
-                            "properties": {
-                              "name": {
-                                "type": "string"
-                              },
-                              "numeric": {
-                                "type": "string"
-                              },
-                              "alpha2": {
-                                "type": "string"
-                              },
-                              "alpha3": {
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "name",
-                              "numeric",
-                              "alpha2",
-                              "alpha3"
-                            ]
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "city"
-                        ]
-                      },
-                      "billingAmount": {
-                        "type": "string"
-                      },
-                      "billingCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionAmount": {
-                        "type": "string"
-                      },
-                      "transactionCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionType": {
-                        "type": "string"
-                      },
-                      "cardToken": {
-                        "type": "string"
-                      },
-                      "impactsCashback": {
-                        "type": "boolean",
-                        "nullable": true
-                      },
-                      "transactions": {
-                        "type": "array",
-                        "items": {
-                          "type": "object",
-                          "properties": {
-                            "status": {
-                              "type": "string",
-                              "enum": [
-                                "Unsubmitted",
-                                "Unconfirmed",
-                                "ExecReverted",
-                                "ExecSuccess"
-                              ]
-                            },
-                            "to": {
-                              "type": "string"
-                            },
-                            "value": {
-                              "type": "string"
-                            },
-                            "data": {
-                              "type": "string"
-                            },
-                            "hash": {
-                              "type": "string",
-                              "nullable": true
-                            }
-                          },
-                          "required": [
-                            "status",
-                            "to",
-                            "value",
-                            "data"
-                          ]
-                        }
-                      },
-                      "kind": {
-                        "type": "string",
-                        "enum": [
-                          "Refund"
-                        ]
-                      },
-                      "refundAmount": {
-                        "type": "string"
-                      },
-                      "refundCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      }
-                    },
-                    "required": [
-                      "threadId",
-                      "createdAt",
-                      "clearedAt",
-                      "isPending",
-                      "country",
-                      "mcc",
-                      "merchant",
-                      "billingAmount",
-                      "billingCurrency",
-                      "transactionAmount",
-                      "transactionCurrency",
-                      "transactionType",
-                      "cardToken",
-                      "transactions",
-                      "kind",
-                      "refundAmount",
-                      "refundCurrency"
-                    ]
-                  },
-                  {
-                    "type": "object",
-                    "properties": {
-                      "threadId": {
-                        "type": "string"
-                      },
-                      "createdAt": {
-                        "type": "string"
-                      },
-                      "clearedAt": {
-                        "type": "string",
-                        "nullable": true
-                      },
-                      "isPending": {
-                        "type": "boolean"
-                      },
-                      "country": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "numeric": {
-                            "type": "string"
-                          },
-                          "alpha2": {
-                            "type": "string"
-                          },
-                          "alpha3": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "numeric",
-                          "alpha2",
-                          "alpha3"
-                        ]
-                      },
-                      "mcc": {
-                        "type": "string"
-                      },
-                      "merchant": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "city": {
-                            "type": "string"
-                          },
-                          "country": {
-                            "type": "object",
-                            "properties": {
-                              "name": {
-                                "type": "string"
-                              },
-                              "numeric": {
-                                "type": "string"
-                              },
-                              "alpha2": {
-                                "type": "string"
-                              },
-                              "alpha3": {
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "name",
-                              "numeric",
-                              "alpha2",
-                              "alpha3"
-                            ]
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "city"
-                        ]
-                      },
-                      "billingAmount": {
-                        "type": "string"
-                      },
-                      "billingCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionAmount": {
-                        "type": "string"
-                      },
-                      "transactionCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionType": {
-                        "type": "string"
-                      },
-                      "cardToken": {
-                        "type": "string"
-                      },
-                      "impactsCashback": {
-                        "type": "boolean",
-                        "nullable": true
-                      },
-                      "transactions": {
-                        "type": "array",
-                        "items": {
-                          "type": "object",
-                          "properties": {
-                            "status": {
-                              "type": "string",
-                              "enum": [
-                                "Unsubmitted",
-                                "Unconfirmed",
-                                "ExecReverted",
-                                "ExecSuccess"
-                              ]
-                            },
-                            "to": {
-                              "type": "string"
-                            },
-                            "value": {
-                              "type": "string"
-                            },
-                            "data": {
-                              "type": "string"
-                            },
-                            "hash": {
-                              "type": "string",
-                              "nullable": true
-                            }
-                          },
-                          "required": [
-                            "status",
-                            "to",
-                            "value",
-                            "data"
-                          ]
-                        }
-                      },
-                      "kind": {
-                        "type": "string",
-                        "enum": [
-                          "Reversal"
-                        ]
-                      },
-                      "reversalAmount": {
-                        "type": "string"
-                      },
-                      "reversalCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      }
-                    },
-                    "required": [
-                      "threadId",
-                      "createdAt",
-                      "clearedAt",
-                      "isPending",
-                      "country",
-                      "mcc",
-                      "merchant",
-                      "billingAmount",
-                      "billingCurrency",
-                      "transactionAmount",
-                      "transactionCurrency",
-                      "transactionType",
-                      "cardToken",
-                      "transactions",
-                      "kind",
-                      "reversalAmount",
-                      "reversalCurrency"
-                    ]
-                  }
-                ],
-                "example": {
-                  "event": {
-                    "kind": "Payment",
-                    "threadId": "thread_123456789",
-                    "createdAt": "2024-01-15T10:30:00.000Z",
-                    "clearedAt": "2024-01-15T10:35:00.000Z",
-                    "isPending": false,
-                    "country": {
-                      "name": "United States",
-                      "numeric": "840",
-                      "alpha2": "US",
-                      "alpha3": "USA"
-                    },
-                    "mcc": "5411",
-                    "merchant": {
-                      "name": "Grocery Store Inc",
-                      "city": "New York",
-                      "country": {
-                        "name": "United States",
-                        "numeric": "840",
-                        "alpha2": "US",
-                        "alpha3": "USA"
-                      }
-                    },
-                    "billingAmount": "5000",
-                    "billingCurrency": {
-                      "symbol": "$",
-                      "code": "840",
-                      "decimals": 2,
-                      "name": "US Dollar"
-                    },
-                    "transactionAmount": "5000",
-                    "transactionCurrency": {
-                      "symbol": "$",
-                      "code": "840",
-                      "decimals": 2,
-                      "name": "US Dollar"
-                    },
-                    "transactionType": "purchase",
-                    "cardToken": "card_token_abc123",
-                    "impactsCashback": true,
-                    "status": "Approved",
-                    "transactions": [
-                      {
-                        "status": "ExecSuccess",
-                        "to": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
-                        "value": "5000000000000000000",
-                        "data": "0x",
-                        "hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
-                      }
-                    ]
-                  }
-                },
-                "description": "Card transaction event"
-              }
-            },
-            "required": [
-              "userId",
-              "event"
-            ]
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when the transaction hash becomes available after broadcast.",
-        "example": {
-          "eventType": "card.transaction.failed",
-          "data": {
-            "userId": "user_123",
-            "event": {
-              "kind": "Payment",
-              "threadId": "thread_123456789",
-              "createdAt": "2024-01-15T10:30:00.000Z",
-              "clearedAt": "2024-01-15T10:35:00.000Z",
-              "isPending": false,
-              "country": {
-                "name": "United States",
-                "numeric": "840",
-                "alpha2": "US",
-                "alpha3": "USA"
-              },
-              "mcc": "5411",
-              "merchant": {
-                "name": "Grocery Store Inc",
-                "city": "New York",
-                "country": {
-                  "name": "United States",
-                  "numeric": "840",
-                  "alpha2": "US",
-                  "alpha3": "USA"
-                }
-              },
-              "billingAmount": "5000",
-              "billingCurrency": {
-                "symbol": "$",
-                "code": "840",
-                "decimals": 2,
-                "name": "US Dollar"
-              },
-              "transactionAmount": "5000",
-              "transactionCurrency": {
-                "symbol": "$",
-                "code": "840",
-                "decimals": 2,
-                "name": "US Dollar"
-              },
-              "transactionType": "purchase",
-              "cardToken": "card_token_abc123",
-              "impactsCashback": true,
-              "status": "Approved",
-              "transactions": [
-                {
-                  "status": "ExecSuccess",
-                  "to": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
-                  "value": "5000000000000000000",
-                  "data": "0x",
-                  "hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
-                }
-              ]
-            }
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "card.transaction.failed",
-  "data": {
-    "userId": "user_123",
-    "event": {
-      "kind": "Payment",
-      "threadId": "thread_123456789",
-      "createdAt": "2024-01-15T10:30:00.000Z",
-      "clearedAt": "2024-01-15T10:35:00.000Z",
-      "isPending": false,
-      "country": {
-        "name": "United States",
-        "numeric": "840",
-        "alpha2": "US",
-        "alpha3": "USA"
-      },
-      "mcc": "5411",
-      "merchant": {
-        "name": "Grocery Store Inc",
-        "city": "New York",
-        "country": {
-          "name": "United States",
-          "numeric": "840",
-          "alpha2": "US",
-          "alpha3": "USA"
-        }
-      },
-      "billingAmount": "5000",
-      "billingCurrency": {
-        "symbol": "$",
-        "code": "840",
-        "decimals": 2,
-        "name": "US Dollar"
-      },
-      "transactionAmount": "5000",
-      "transactionCurrency": {
-        "symbol": "$",
-        "code": "840",
-        "decimals": 2,
-        "name": "US Dollar"
-      },
-      "transactionType": "purchase",
-      "cardToken": "card_token_abc123",
-      "impactsCashback": true,
-      "status": "Approved",
-      "transactions": [
-        {
-          "status": "ExecSuccess",
-          "to": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
-          "value": "5000000000000000000",
-          "data": "0x",
-          "hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
-        }
-      ]
-    }
-  }
-}
-```
-
-### card.transaction.reversed
-
-Triggered when a reversal event is detected during clearing.
-
-**Event Type**: `card.transaction.reversed`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "card.transaction.reversed";
-  data: {
-    /** User ID */
-    userId: string;
-    /** Card transaction event */
-    event: {
-      threadId: string;
-      createdAt: string;
-      clearedAt: string;
-      isPending: boolean;
-      country: {
-        name: string;
-        numeric: string;
-        alpha2: string;
-        alpha3: string;
-      };
-      mcc: string;
-      merchant: {
-        name: string;
-        city: string;
-        country?: {
-          name: string;
-          numeric: string;
-          alpha2: string;
-          alpha3: string;
-        };
-      };
-      billingAmount: string;
-      billingCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionAmount: string;
-      transactionCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionType: string;
-      cardToken: string;
-      impactsCashback: boolean | null;
-      transactions: {
-        status: "Unsubmitted" | "Unconfirmed" | "ExecReverted" | "ExecSuccess";
-        to: string;
-        value: string;
-        data: string;
-        hash: string | null;
-      }[];
-      kind: "Payment";
-      status: "Approved" | "IncorrectPin" | "InsufficientFunds" | "ExceedsApprovalAmountLimit" | "InvalidAmount" | "PinEntryTriesExceeded" | "IncorrectSecurityCode" | "Reversal" | "PartialReversal" | "Other";
-    } | {
-      threadId: string;
-      createdAt: string;
-      clearedAt: string;
-      isPending: boolean;
-      country: {
-        name: string;
-        numeric: string;
-        alpha2: string;
-        alpha3: string;
-      };
-      mcc: string;
-      merchant: {
-        name: string;
-        city: string;
-        country?: {
-          name: string;
-          numeric: string;
-          alpha2: string;
-          alpha3: string;
-        };
-      };
-      billingAmount: string;
-      billingCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionAmount: string;
-      transactionCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionType: string;
-      cardToken: string;
-      impactsCashback: boolean | null;
-      transactions: {
-        status: "Unsubmitted" | "Unconfirmed" | "ExecReverted" | "ExecSuccess";
-        to: string;
-        value: string;
-        data: string;
-        hash: string | null;
-      }[];
-      kind: "Refund";
-      refundAmount: string;
-      refundCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-    } | {
-      threadId: string;
-      createdAt: string;
-      clearedAt: string;
-      isPending: boolean;
-      country: {
-        name: string;
-        numeric: string;
-        alpha2: string;
-        alpha3: string;
-      };
-      mcc: string;
-      merchant: {
-        name: string;
-        city: string;
-        country?: {
-          name: string;
-          numeric: string;
-          alpha2: string;
-          alpha3: string;
-        };
-      };
-      billingAmount: string;
-      billingCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionAmount: string;
-      transactionCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionType: string;
-      cardToken: string;
-      impactsCashback: boolean | null;
-      transactions: {
-        status: "Unsubmitted" | "Unconfirmed" | "ExecReverted" | "ExecSuccess";
-        to: string;
-        value: string;
-        data: string;
-        hash: string | null;
-      }[];
-      kind: "Reversal";
-      reversalAmount: string;
-      reversalCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-    };
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "card.transaction.reversed Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when the transaction hash becomes available after broadcast."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "card.transaction.reversed"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "userId": {
-                "type": "string",
-                "description": "User ID"
-              },
-              "event": {
-                "anyOf": [
-                  {
-                    "type": "object",
-                    "properties": {
-                      "threadId": {
-                        "type": "string"
-                      },
-                      "createdAt": {
-                        "type": "string"
-                      },
-                      "clearedAt": {
-                        "type": "string",
-                        "nullable": true
-                      },
-                      "isPending": {
-                        "type": "boolean"
-                      },
-                      "country": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "numeric": {
-                            "type": "string"
-                          },
-                          "alpha2": {
-                            "type": "string"
-                          },
-                          "alpha3": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "numeric",
-                          "alpha2",
-                          "alpha3"
-                        ]
-                      },
-                      "mcc": {
-                        "type": "string"
-                      },
-                      "merchant": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "city": {
-                            "type": "string"
-                          },
-                          "country": {
-                            "type": "object",
-                            "properties": {
-                              "name": {
-                                "type": "string"
-                              },
-                              "numeric": {
-                                "type": "string"
-                              },
-                              "alpha2": {
-                                "type": "string"
-                              },
-                              "alpha3": {
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "name",
-                              "numeric",
-                              "alpha2",
-                              "alpha3"
-                            ]
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "city"
-                        ]
-                      },
-                      "billingAmount": {
-                        "type": "string"
-                      },
-                      "billingCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionAmount": {
-                        "type": "string"
-                      },
-                      "transactionCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionType": {
-                        "type": "string"
-                      },
-                      "cardToken": {
-                        "type": "string"
-                      },
-                      "impactsCashback": {
-                        "type": "boolean",
-                        "nullable": true
-                      },
-                      "transactions": {
-                        "type": "array",
-                        "items": {
-                          "type": "object",
-                          "properties": {
-                            "status": {
-                              "type": "string",
-                              "enum": [
-                                "Unsubmitted",
-                                "Unconfirmed",
-                                "ExecReverted",
-                                "ExecSuccess"
-                              ]
-                            },
-                            "to": {
-                              "type": "string"
-                            },
-                            "value": {
-                              "type": "string"
-                            },
-                            "data": {
-                              "type": "string"
-                            },
-                            "hash": {
-                              "type": "string",
-                              "nullable": true
-                            }
-                          },
-                          "required": [
-                            "status",
-                            "to",
-                            "value",
-                            "data"
-                          ]
-                        }
-                      },
-                      "kind": {
-                        "type": "string",
-                        "enum": [
-                          "Payment"
-                        ]
-                      },
-                      "status": {
-                        "type": "string",
-                        "enum": [
-                          "Approved",
-                          "IncorrectPin",
-                          "InsufficientFunds",
-                          "ExceedsApprovalAmountLimit",
-                          "InvalidAmount",
-                          "PinEntryTriesExceeded",
-                          "IncorrectSecurityCode",
-                          "Reversal",
-                          "PartialReversal",
-                          "Other"
-                        ]
-                      }
-                    },
-                    "required": [
-                      "threadId",
-                      "createdAt",
-                      "clearedAt",
-                      "isPending",
-                      "country",
-                      "mcc",
-                      "merchant",
-                      "billingAmount",
-                      "billingCurrency",
-                      "transactionAmount",
-                      "transactionCurrency",
-                      "transactionType",
-                      "cardToken",
-                      "transactions",
-                      "kind",
-                      "status"
-                    ]
-                  },
-                  {
-                    "type": "object",
-                    "properties": {
-                      "threadId": {
-                        "type": "string"
-                      },
-                      "createdAt": {
-                        "type": "string"
-                      },
-                      "clearedAt": {
-                        "type": "string",
-                        "nullable": true
-                      },
-                      "isPending": {
-                        "type": "boolean"
-                      },
-                      "country": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "numeric": {
-                            "type": "string"
-                          },
-                          "alpha2": {
-                            "type": "string"
-                          },
-                          "alpha3": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "numeric",
-                          "alpha2",
-                          "alpha3"
-                        ]
-                      },
-                      "mcc": {
-                        "type": "string"
-                      },
-                      "merchant": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "city": {
-                            "type": "string"
-                          },
-                          "country": {
-                            "type": "object",
-                            "properties": {
-                              "name": {
-                                "type": "string"
-                              },
-                              "numeric": {
-                                "type": "string"
-                              },
-                              "alpha2": {
-                                "type": "string"
-                              },
-                              "alpha3": {
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "name",
-                              "numeric",
-                              "alpha2",
-                              "alpha3"
-                            ]
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "city"
-                        ]
-                      },
-                      "billingAmount": {
-                        "type": "string"
-                      },
-                      "billingCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionAmount": {
-                        "type": "string"
-                      },
-                      "transactionCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionType": {
-                        "type": "string"
-                      },
-                      "cardToken": {
-                        "type": "string"
-                      },
-                      "impactsCashback": {
-                        "type": "boolean",
-                        "nullable": true
-                      },
-                      "transactions": {
-                        "type": "array",
-                        "items": {
-                          "type": "object",
-                          "properties": {
-                            "status": {
-                              "type": "string",
-                              "enum": [
-                                "Unsubmitted",
-                                "Unconfirmed",
-                                "ExecReverted",
-                                "ExecSuccess"
-                              ]
-                            },
-                            "to": {
-                              "type": "string"
-                            },
-                            "value": {
-                              "type": "string"
-                            },
-                            "data": {
-                              "type": "string"
-                            },
-                            "hash": {
-                              "type": "string",
-                              "nullable": true
-                            }
-                          },
-                          "required": [
-                            "status",
-                            "to",
-                            "value",
-                            "data"
-                          ]
-                        }
-                      },
-                      "kind": {
-                        "type": "string",
-                        "enum": [
-                          "Refund"
-                        ]
-                      },
-                      "refundAmount": {
-                        "type": "string"
-                      },
-                      "refundCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      }
-                    },
-                    "required": [
-                      "threadId",
-                      "createdAt",
-                      "clearedAt",
-                      "isPending",
-                      "country",
-                      "mcc",
-                      "merchant",
-                      "billingAmount",
-                      "billingCurrency",
-                      "transactionAmount",
-                      "transactionCurrency",
-                      "transactionType",
-                      "cardToken",
-                      "transactions",
-                      "kind",
-                      "refundAmount",
-                      "refundCurrency"
-                    ]
-                  },
-                  {
-                    "type": "object",
-                    "properties": {
-                      "threadId": {
-                        "type": "string"
-                      },
-                      "createdAt": {
-                        "type": "string"
-                      },
-                      "clearedAt": {
-                        "type": "string",
-                        "nullable": true
-                      },
-                      "isPending": {
-                        "type": "boolean"
-                      },
-                      "country": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "numeric": {
-                            "type": "string"
-                          },
-                          "alpha2": {
-                            "type": "string"
-                          },
-                          "alpha3": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "numeric",
-                          "alpha2",
-                          "alpha3"
-                        ]
-                      },
-                      "mcc": {
-                        "type": "string"
-                      },
-                      "merchant": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "city": {
-                            "type": "string"
-                          },
-                          "country": {
-                            "type": "object",
-                            "properties": {
-                              "name": {
-                                "type": "string"
-                              },
-                              "numeric": {
-                                "type": "string"
-                              },
-                              "alpha2": {
-                                "type": "string"
-                              },
-                              "alpha3": {
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "name",
-                              "numeric",
-                              "alpha2",
-                              "alpha3"
-                            ]
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "city"
-                        ]
-                      },
-                      "billingAmount": {
-                        "type": "string"
-                      },
-                      "billingCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionAmount": {
-                        "type": "string"
-                      },
-                      "transactionCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionType": {
-                        "type": "string"
-                      },
-                      "cardToken": {
-                        "type": "string"
-                      },
-                      "impactsCashback": {
-                        "type": "boolean",
-                        "nullable": true
-                      },
-                      "transactions": {
-                        "type": "array",
-                        "items": {
-                          "type": "object",
-                          "properties": {
-                            "status": {
-                              "type": "string",
-                              "enum": [
-                                "Unsubmitted",
-                                "Unconfirmed",
-                                "ExecReverted",
-                                "ExecSuccess"
-                              ]
-                            },
-                            "to": {
-                              "type": "string"
-                            },
-                            "value": {
-                              "type": "string"
-                            },
-                            "data": {
-                              "type": "string"
-                            },
-                            "hash": {
-                              "type": "string",
-                              "nullable": true
-                            }
-                          },
-                          "required": [
-                            "status",
-                            "to",
-                            "value",
-                            "data"
-                          ]
-                        }
-                      },
-                      "kind": {
-                        "type": "string",
-                        "enum": [
-                          "Reversal"
-                        ]
-                      },
-                      "reversalAmount": {
-                        "type": "string"
-                      },
-                      "reversalCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      }
-                    },
-                    "required": [
-                      "threadId",
-                      "createdAt",
-                      "clearedAt",
-                      "isPending",
-                      "country",
-                      "mcc",
-                      "merchant",
-                      "billingAmount",
-                      "billingCurrency",
-                      "transactionAmount",
-                      "transactionCurrency",
-                      "transactionType",
-                      "cardToken",
-                      "transactions",
-                      "kind",
-                      "reversalAmount",
-                      "reversalCurrency"
-                    ]
-                  }
-                ],
-                "example": {
-                  "event": {
-                    "kind": "Payment",
-                    "threadId": "thread_123456789",
-                    "createdAt": "2024-01-15T10:30:00.000Z",
-                    "clearedAt": "2024-01-15T10:35:00.000Z",
-                    "isPending": false,
-                    "country": {
-                      "name": "United States",
-                      "numeric": "840",
-                      "alpha2": "US",
-                      "alpha3": "USA"
-                    },
-                    "mcc": "5411",
-                    "merchant": {
-                      "name": "Grocery Store Inc",
-                      "city": "New York",
-                      "country": {
-                        "name": "United States",
-                        "numeric": "840",
-                        "alpha2": "US",
-                        "alpha3": "USA"
-                      }
-                    },
-                    "billingAmount": "5000",
-                    "billingCurrency": {
-                      "symbol": "$",
-                      "code": "840",
-                      "decimals": 2,
-                      "name": "US Dollar"
-                    },
-                    "transactionAmount": "5000",
-                    "transactionCurrency": {
-                      "symbol": "$",
-                      "code": "840",
-                      "decimals": 2,
-                      "name": "US Dollar"
-                    },
-                    "transactionType": "purchase",
-                    "cardToken": "card_token_abc123",
-                    "impactsCashback": true,
-                    "status": "Approved",
-                    "transactions": [
-                      {
-                        "status": "ExecSuccess",
-                        "to": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
-                        "value": "5000000000000000000",
-                        "data": "0x",
-                        "hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
-                      }
-                    ]
-                  }
-                },
-                "description": "Card transaction event"
-              }
-            },
-            "required": [
-              "userId",
-              "event"
-            ]
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when the transaction hash becomes available after broadcast.",
-        "example": {
-          "eventType": "card.transaction.reversed",
-          "data": {
-            "userId": "user_123",
-            "event": {
-              "kind": "Payment",
-              "threadId": "thread_123456789",
-              "createdAt": "2024-01-15T10:30:00.000Z",
-              "clearedAt": "2024-01-15T10:35:00.000Z",
-              "isPending": false,
-              "country": {
-                "name": "United States",
-                "numeric": "840",
-                "alpha2": "US",
-                "alpha3": "USA"
-              },
-              "mcc": "5411",
-              "merchant": {
-                "name": "Grocery Store Inc",
-                "city": "New York",
-                "country": {
-                  "name": "United States",
-                  "numeric": "840",
-                  "alpha2": "US",
-                  "alpha3": "USA"
-                }
-              },
-              "billingAmount": "5000",
-              "billingCurrency": {
-                "symbol": "$",
-                "code": "840",
-                "decimals": 2,
-                "name": "US Dollar"
-              },
-              "transactionAmount": "5000",
-              "transactionCurrency": {
-                "symbol": "$",
-                "code": "840",
-                "decimals": 2,
-                "name": "US Dollar"
-              },
-              "transactionType": "purchase",
-              "cardToken": "card_token_abc123",
-              "impactsCashback": true,
-              "status": "Approved",
-              "transactions": [
-                {
-                  "status": "ExecSuccess",
-                  "to": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
-                  "value": "5000000000000000000",
-                  "data": "0x",
-                  "hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
-                }
-              ]
-            }
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "card.transaction.reversed",
-  "data": {
-    "userId": "user_123",
-    "event": {
-      "kind": "Payment",
-      "threadId": "thread_123456789",
-      "createdAt": "2024-01-15T10:30:00.000Z",
-      "clearedAt": "2024-01-15T10:35:00.000Z",
-      "isPending": false,
-      "country": {
-        "name": "United States",
-        "numeric": "840",
-        "alpha2": "US",
-        "alpha3": "USA"
-      },
-      "mcc": "5411",
-      "merchant": {
-        "name": "Grocery Store Inc",
-        "city": "New York",
-        "country": {
-          "name": "United States",
-          "numeric": "840",
-          "alpha2": "US",
-          "alpha3": "USA"
-        }
-      },
-      "billingAmount": "5000",
-      "billingCurrency": {
-        "symbol": "$",
-        "code": "840",
-        "decimals": 2,
-        "name": "US Dollar"
-      },
-      "transactionAmount": "5000",
-      "transactionCurrency": {
-        "symbol": "$",
-        "code": "840",
-        "decimals": 2,
-        "name": "US Dollar"
-      },
-      "transactionType": "purchase",
-      "cardToken": "card_token_abc123",
-      "impactsCashback": true,
-      "status": "Approved",
-      "transactions": [
-        {
-          "status": "ExecSuccess",
-          "to": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
-          "value": "5000000000000000000",
-          "data": "0x",
-          "hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
-        }
-      ]
-    }
-  }
-}
-```
-
-### card.transaction.refunded
-
-Triggered when a refund event is detected during clearing.
-
-**Event Type**: `card.transaction.refunded`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "card.transaction.refunded";
-  data: {
-    /** User ID */
-    userId: string;
-    /** Card transaction event */
-    event: {
-      threadId: string;
-      createdAt: string;
-      clearedAt: string;
-      isPending: boolean;
-      country: {
-        name: string;
-        numeric: string;
-        alpha2: string;
-        alpha3: string;
-      };
-      mcc: string;
-      merchant: {
-        name: string;
-        city: string;
-        country?: {
-          name: string;
-          numeric: string;
-          alpha2: string;
-          alpha3: string;
-        };
-      };
-      billingAmount: string;
-      billingCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionAmount: string;
-      transactionCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionType: string;
-      cardToken: string;
-      impactsCashback: boolean | null;
-      transactions: {
-        status: "Unsubmitted" | "Unconfirmed" | "ExecReverted" | "ExecSuccess";
-        to: string;
-        value: string;
-        data: string;
-        hash: string | null;
-      }[];
-      kind: "Payment";
-      status: "Approved" | "IncorrectPin" | "InsufficientFunds" | "ExceedsApprovalAmountLimit" | "InvalidAmount" | "PinEntryTriesExceeded" | "IncorrectSecurityCode" | "Reversal" | "PartialReversal" | "Other";
-    } | {
-      threadId: string;
-      createdAt: string;
-      clearedAt: string;
-      isPending: boolean;
-      country: {
-        name: string;
-        numeric: string;
-        alpha2: string;
-        alpha3: string;
-      };
-      mcc: string;
-      merchant: {
-        name: string;
-        city: string;
-        country?: {
-          name: string;
-          numeric: string;
-          alpha2: string;
-          alpha3: string;
-        };
-      };
-      billingAmount: string;
-      billingCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionAmount: string;
-      transactionCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionType: string;
-      cardToken: string;
-      impactsCashback: boolean | null;
-      transactions: {
-        status: "Unsubmitted" | "Unconfirmed" | "ExecReverted" | "ExecSuccess";
-        to: string;
-        value: string;
-        data: string;
-        hash: string | null;
-      }[];
-      kind: "Refund";
-      refundAmount: string;
-      refundCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-    } | {
-      threadId: string;
-      createdAt: string;
-      clearedAt: string;
-      isPending: boolean;
-      country: {
-        name: string;
-        numeric: string;
-        alpha2: string;
-        alpha3: string;
-      };
-      mcc: string;
-      merchant: {
-        name: string;
-        city: string;
-        country?: {
-          name: string;
-          numeric: string;
-          alpha2: string;
-          alpha3: string;
-        };
-      };
-      billingAmount: string;
-      billingCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionAmount: string;
-      transactionCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionType: string;
-      cardToken: string;
-      impactsCashback: boolean | null;
-      transactions: {
-        status: "Unsubmitted" | "Unconfirmed" | "ExecReverted" | "ExecSuccess";
-        to: string;
-        value: string;
-        data: string;
-        hash: string | null;
-      }[];
-      kind: "Reversal";
-      reversalAmount: string;
-      reversalCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-    };
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "card.transaction.refunded Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when the transaction hash becomes available after broadcast."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "card.transaction.refunded"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "userId": {
-                "type": "string",
-                "description": "User ID"
-              },
-              "event": {
-                "anyOf": [
-                  {
-                    "type": "object",
-                    "properties": {
-                      "threadId": {
-                        "type": "string"
-                      },
-                      "createdAt": {
-                        "type": "string"
-                      },
-                      "clearedAt": {
-                        "type": "string",
-                        "nullable": true
-                      },
-                      "isPending": {
-                        "type": "boolean"
-                      },
-                      "country": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "numeric": {
-                            "type": "string"
-                          },
-                          "alpha2": {
-                            "type": "string"
-                          },
-                          "alpha3": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "numeric",
-                          "alpha2",
-                          "alpha3"
-                        ]
-                      },
-                      "mcc": {
-                        "type": "string"
-                      },
-                      "merchant": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "city": {
-                            "type": "string"
-                          },
-                          "country": {
-                            "type": "object",
-                            "properties": {
-                              "name": {
-                                "type": "string"
-                              },
-                              "numeric": {
-                                "type": "string"
-                              },
-                              "alpha2": {
-                                "type": "string"
-                              },
-                              "alpha3": {
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "name",
-                              "numeric",
-                              "alpha2",
-                              "alpha3"
-                            ]
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "city"
-                        ]
-                      },
-                      "billingAmount": {
-                        "type": "string"
-                      },
-                      "billingCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionAmount": {
-                        "type": "string"
-                      },
-                      "transactionCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionType": {
-                        "type": "string"
-                      },
-                      "cardToken": {
-                        "type": "string"
-                      },
-                      "impactsCashback": {
-                        "type": "boolean",
-                        "nullable": true
-                      },
-                      "transactions": {
-                        "type": "array",
-                        "items": {
-                          "type": "object",
-                          "properties": {
-                            "status": {
-                              "type": "string",
-                              "enum": [
-                                "Unsubmitted",
-                                "Unconfirmed",
-                                "ExecReverted",
-                                "ExecSuccess"
-                              ]
-                            },
-                            "to": {
-                              "type": "string"
-                            },
-                            "value": {
-                              "type": "string"
-                            },
-                            "data": {
-                              "type": "string"
-                            },
-                            "hash": {
-                              "type": "string",
-                              "nullable": true
-                            }
-                          },
-                          "required": [
-                            "status",
-                            "to",
-                            "value",
-                            "data"
-                          ]
-                        }
-                      },
-                      "kind": {
-                        "type": "string",
-                        "enum": [
-                          "Payment"
-                        ]
-                      },
-                      "status": {
-                        "type": "string",
-                        "enum": [
-                          "Approved",
-                          "IncorrectPin",
-                          "InsufficientFunds",
-                          "ExceedsApprovalAmountLimit",
-                          "InvalidAmount",
-                          "PinEntryTriesExceeded",
-                          "IncorrectSecurityCode",
-                          "Reversal",
-                          "PartialReversal",
-                          "Other"
-                        ]
-                      }
-                    },
-                    "required": [
-                      "threadId",
-                      "createdAt",
-                      "clearedAt",
-                      "isPending",
-                      "country",
-                      "mcc",
-                      "merchant",
-                      "billingAmount",
-                      "billingCurrency",
-                      "transactionAmount",
-                      "transactionCurrency",
-                      "transactionType",
-                      "cardToken",
-                      "transactions",
-                      "kind",
-                      "status"
-                    ]
-                  },
-                  {
-                    "type": "object",
-                    "properties": {
-                      "threadId": {
-                        "type": "string"
-                      },
-                      "createdAt": {
-                        "type": "string"
-                      },
-                      "clearedAt": {
-                        "type": "string",
-                        "nullable": true
-                      },
-                      "isPending": {
-                        "type": "boolean"
-                      },
-                      "country": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "numeric": {
-                            "type": "string"
-                          },
-                          "alpha2": {
-                            "type": "string"
-                          },
-                          "alpha3": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "numeric",
-                          "alpha2",
-                          "alpha3"
-                        ]
-                      },
-                      "mcc": {
-                        "type": "string"
-                      },
-                      "merchant": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "city": {
-                            "type": "string"
-                          },
-                          "country": {
-                            "type": "object",
-                            "properties": {
-                              "name": {
-                                "type": "string"
-                              },
-                              "numeric": {
-                                "type": "string"
-                              },
-                              "alpha2": {
-                                "type": "string"
-                              },
-                              "alpha3": {
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "name",
-                              "numeric",
-                              "alpha2",
-                              "alpha3"
-                            ]
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "city"
-                        ]
-                      },
-                      "billingAmount": {
-                        "type": "string"
-                      },
-                      "billingCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionAmount": {
-                        "type": "string"
-                      },
-                      "transactionCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionType": {
-                        "type": "string"
-                      },
-                      "cardToken": {
-                        "type": "string"
-                      },
-                      "impactsCashback": {
-                        "type": "boolean",
-                        "nullable": true
-                      },
-                      "transactions": {
-                        "type": "array",
-                        "items": {
-                          "type": "object",
-                          "properties": {
-                            "status": {
-                              "type": "string",
-                              "enum": [
-                                "Unsubmitted",
-                                "Unconfirmed",
-                                "ExecReverted",
-                                "ExecSuccess"
-                              ]
-                            },
-                            "to": {
-                              "type": "string"
-                            },
-                            "value": {
-                              "type": "string"
-                            },
-                            "data": {
-                              "type": "string"
-                            },
-                            "hash": {
-                              "type": "string",
-                              "nullable": true
-                            }
-                          },
-                          "required": [
-                            "status",
-                            "to",
-                            "value",
-                            "data"
-                          ]
-                        }
-                      },
-                      "kind": {
-                        "type": "string",
-                        "enum": [
-                          "Refund"
-                        ]
-                      },
-                      "refundAmount": {
-                        "type": "string"
-                      },
-                      "refundCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      }
-                    },
-                    "required": [
-                      "threadId",
-                      "createdAt",
-                      "clearedAt",
-                      "isPending",
-                      "country",
-                      "mcc",
-                      "merchant",
-                      "billingAmount",
-                      "billingCurrency",
-                      "transactionAmount",
-                      "transactionCurrency",
-                      "transactionType",
-                      "cardToken",
-                      "transactions",
-                      "kind",
-                      "refundAmount",
-                      "refundCurrency"
-                    ]
-                  },
-                  {
-                    "type": "object",
-                    "properties": {
-                      "threadId": {
-                        "type": "string"
-                      },
-                      "createdAt": {
-                        "type": "string"
-                      },
-                      "clearedAt": {
-                        "type": "string",
-                        "nullable": true
-                      },
-                      "isPending": {
-                        "type": "boolean"
-                      },
-                      "country": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "numeric": {
-                            "type": "string"
-                          },
-                          "alpha2": {
-                            "type": "string"
-                          },
-                          "alpha3": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "numeric",
-                          "alpha2",
-                          "alpha3"
-                        ]
-                      },
-                      "mcc": {
-                        "type": "string"
-                      },
-                      "merchant": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "city": {
-                            "type": "string"
-                          },
-                          "country": {
-                            "type": "object",
-                            "properties": {
-                              "name": {
-                                "type": "string"
-                              },
-                              "numeric": {
-                                "type": "string"
-                              },
-                              "alpha2": {
-                                "type": "string"
-                              },
-                              "alpha3": {
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "name",
-                              "numeric",
-                              "alpha2",
-                              "alpha3"
-                            ]
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "city"
-                        ]
-                      },
-                      "billingAmount": {
-                        "type": "string"
-                      },
-                      "billingCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionAmount": {
-                        "type": "string"
-                      },
-                      "transactionCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionType": {
-                        "type": "string"
-                      },
-                      "cardToken": {
-                        "type": "string"
-                      },
-                      "impactsCashback": {
-                        "type": "boolean",
-                        "nullable": true
-                      },
-                      "transactions": {
-                        "type": "array",
-                        "items": {
-                          "type": "object",
-                          "properties": {
-                            "status": {
-                              "type": "string",
-                              "enum": [
-                                "Unsubmitted",
-                                "Unconfirmed",
-                                "ExecReverted",
-                                "ExecSuccess"
-                              ]
-                            },
-                            "to": {
-                              "type": "string"
-                            },
-                            "value": {
-                              "type": "string"
-                            },
-                            "data": {
-                              "type": "string"
-                            },
-                            "hash": {
-                              "type": "string",
-                              "nullable": true
-                            }
-                          },
-                          "required": [
-                            "status",
-                            "to",
-                            "value",
-                            "data"
-                          ]
-                        }
-                      },
-                      "kind": {
-                        "type": "string",
-                        "enum": [
-                          "Reversal"
-                        ]
-                      },
-                      "reversalAmount": {
-                        "type": "string"
-                      },
-                      "reversalCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      }
-                    },
-                    "required": [
-                      "threadId",
-                      "createdAt",
-                      "clearedAt",
-                      "isPending",
-                      "country",
-                      "mcc",
-                      "merchant",
-                      "billingAmount",
-                      "billingCurrency",
-                      "transactionAmount",
-                      "transactionCurrency",
-                      "transactionType",
-                      "cardToken",
-                      "transactions",
-                      "kind",
-                      "reversalAmount",
-                      "reversalCurrency"
-                    ]
-                  }
-                ],
-                "example": {
-                  "event": {
-                    "kind": "Payment",
-                    "threadId": "thread_123456789",
-                    "createdAt": "2024-01-15T10:30:00.000Z",
-                    "clearedAt": "2024-01-15T10:35:00.000Z",
-                    "isPending": false,
-                    "country": {
-                      "name": "United States",
-                      "numeric": "840",
-                      "alpha2": "US",
-                      "alpha3": "USA"
-                    },
-                    "mcc": "5411",
-                    "merchant": {
-                      "name": "Grocery Store Inc",
-                      "city": "New York",
-                      "country": {
-                        "name": "United States",
-                        "numeric": "840",
-                        "alpha2": "US",
-                        "alpha3": "USA"
-                      }
-                    },
-                    "billingAmount": "5000",
-                    "billingCurrency": {
-                      "symbol": "$",
-                      "code": "840",
-                      "decimals": 2,
-                      "name": "US Dollar"
-                    },
-                    "transactionAmount": "5000",
-                    "transactionCurrency": {
-                      "symbol": "$",
-                      "code": "840",
-                      "decimals": 2,
-                      "name": "US Dollar"
-                    },
-                    "transactionType": "purchase",
-                    "cardToken": "card_token_abc123",
-                    "impactsCashback": true,
-                    "status": "Approved",
-                    "transactions": [
-                      {
-                        "status": "ExecSuccess",
-                        "to": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
-                        "value": "5000000000000000000",
-                        "data": "0x",
-                        "hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
-                      }
-                    ]
-                  }
-                },
-                "description": "Card transaction event"
-              }
-            },
-            "required": [
-              "userId",
-              "event"
-            ]
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when the transaction hash becomes available after broadcast.",
-        "example": {
-          "eventType": "card.transaction.refunded",
-          "data": {
-            "userId": "user_123",
-            "event": {
-              "kind": "Payment",
-              "threadId": "thread_123456789",
-              "createdAt": "2024-01-15T10:30:00.000Z",
-              "clearedAt": "2024-01-15T10:35:00.000Z",
-              "isPending": false,
-              "country": {
-                "name": "United States",
-                "numeric": "840",
-                "alpha2": "US",
-                "alpha3": "USA"
-              },
-              "mcc": "5411",
-              "merchant": {
-                "name": "Grocery Store Inc",
-                "city": "New York",
-                "country": {
-                  "name": "United States",
-                  "numeric": "840",
-                  "alpha2": "US",
-                  "alpha3": "USA"
-                }
-              },
-              "billingAmount": "5000",
-              "billingCurrency": {
-                "symbol": "$",
-                "code": "840",
-                "decimals": 2,
-                "name": "US Dollar"
-              },
-              "transactionAmount": "5000",
-              "transactionCurrency": {
-                "symbol": "$",
-                "code": "840",
-                "decimals": 2,
-                "name": "US Dollar"
-              },
-              "transactionType": "purchase",
-              "cardToken": "card_token_abc123",
-              "impactsCashback": true,
-              "status": "Approved",
-              "transactions": [
-                {
-                  "status": "ExecSuccess",
-                  "to": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
-                  "value": "5000000000000000000",
-                  "data": "0x",
-                  "hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
-                }
-              ]
-            }
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "card.transaction.refunded",
-  "data": {
-    "userId": "user_123",
-    "event": {
-      "kind": "Payment",
-      "threadId": "thread_123456789",
-      "createdAt": "2024-01-15T10:30:00.000Z",
-      "clearedAt": "2024-01-15T10:35:00.000Z",
-      "isPending": false,
-      "country": {
-        "name": "United States",
-        "numeric": "840",
-        "alpha2": "US",
-        "alpha3": "USA"
-      },
-      "mcc": "5411",
-      "merchant": {
-        "name": "Grocery Store Inc",
-        "city": "New York",
-        "country": {
-          "name": "United States",
-          "numeric": "840",
-          "alpha2": "US",
-          "alpha3": "USA"
-        }
-      },
-      "billingAmount": "5000",
-      "billingCurrency": {
-        "symbol": "$",
-        "code": "840",
-        "decimals": 2,
-        "name": "US Dollar"
-      },
-      "transactionAmount": "5000",
-      "transactionCurrency": {
-        "symbol": "$",
-        "code": "840",
-        "decimals": 2,
-        "name": "US Dollar"
-      },
-      "transactionType": "purchase",
-      "cardToken": "card_token_abc123",
-      "impactsCashback": true,
-      "status": "Approved",
-      "transactions": [
-        {
-          "status": "ExecSuccess",
-          "to": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
-          "value": "5000000000000000000",
-          "data": "0x",
-          "hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
-        }
-      ]
-    }
-  }
-}
-```
-
-### card.transaction.declined
-
-Triggered when an authorization record is created with a declined response.
-
-**Event Type**: `card.transaction.declined`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "card.transaction.declined";
-  data: {
-    /** User ID */
-    userId: string;
-    /** Card transaction event */
-    event: {
-      threadId: string;
-      createdAt: string;
-      clearedAt: string;
-      isPending: boolean;
-      country: {
-        name: string;
-        numeric: string;
-        alpha2: string;
-        alpha3: string;
-      };
-      mcc: string;
-      merchant: {
-        name: string;
-        city: string;
-        country?: {
-          name: string;
-          numeric: string;
-          alpha2: string;
-          alpha3: string;
-        };
-      };
-      billingAmount: string;
-      billingCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionAmount: string;
-      transactionCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionType: string;
-      cardToken: string;
-      impactsCashback: boolean | null;
-      transactions: {
-        status: "Unsubmitted" | "Unconfirmed" | "ExecReverted" | "ExecSuccess";
-        to: string;
-        value: string;
-        data: string;
-        hash: string | null;
-      }[];
-      kind: "Payment";
-      status: "Approved" | "IncorrectPin" | "InsufficientFunds" | "ExceedsApprovalAmountLimit" | "InvalidAmount" | "PinEntryTriesExceeded" | "IncorrectSecurityCode" | "Reversal" | "PartialReversal" | "Other";
-    } | {
-      threadId: string;
-      createdAt: string;
-      clearedAt: string;
-      isPending: boolean;
-      country: {
-        name: string;
-        numeric: string;
-        alpha2: string;
-        alpha3: string;
-      };
-      mcc: string;
-      merchant: {
-        name: string;
-        city: string;
-        country?: {
-          name: string;
-          numeric: string;
-          alpha2: string;
-          alpha3: string;
-        };
-      };
-      billingAmount: string;
-      billingCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionAmount: string;
-      transactionCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionType: string;
-      cardToken: string;
-      impactsCashback: boolean | null;
-      transactions: {
-        status: "Unsubmitted" | "Unconfirmed" | "ExecReverted" | "ExecSuccess";
-        to: string;
-        value: string;
-        data: string;
-        hash: string | null;
-      }[];
-      kind: "Refund";
-      refundAmount: string;
-      refundCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-    } | {
-      threadId: string;
-      createdAt: string;
-      clearedAt: string;
-      isPending: boolean;
-      country: {
-        name: string;
-        numeric: string;
-        alpha2: string;
-        alpha3: string;
-      };
-      mcc: string;
-      merchant: {
-        name: string;
-        city: string;
-        country?: {
-          name: string;
-          numeric: string;
-          alpha2: string;
-          alpha3: string;
-        };
-      };
-      billingAmount: string;
-      billingCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionAmount: string;
-      transactionCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-      transactionType: string;
-      cardToken: string;
-      impactsCashback: boolean | null;
-      transactions: {
-        status: "Unsubmitted" | "Unconfirmed" | "ExecReverted" | "ExecSuccess";
-        to: string;
-        value: string;
-        data: string;
-        hash: string | null;
-      }[];
-      kind: "Reversal";
-      reversalAmount: string;
-      reversalCurrency: {
-        symbol: string;
-        code: string;
-        decimals: number;
-        name: string;
-      };
-    };
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "card.transaction.declined Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when the transaction hash becomes available after broadcast."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "card.transaction.declined"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "userId": {
-                "type": "string",
-                "description": "User ID"
-              },
-              "event": {
-                "anyOf": [
-                  {
-                    "type": "object",
-                    "properties": {
-                      "threadId": {
-                        "type": "string"
-                      },
-                      "createdAt": {
-                        "type": "string"
-                      },
-                      "clearedAt": {
-                        "type": "string",
-                        "nullable": true
-                      },
-                      "isPending": {
-                        "type": "boolean"
-                      },
-                      "country": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "numeric": {
-                            "type": "string"
-                          },
-                          "alpha2": {
-                            "type": "string"
-                          },
-                          "alpha3": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "numeric",
-                          "alpha2",
-                          "alpha3"
-                        ]
-                      },
-                      "mcc": {
-                        "type": "string"
-                      },
-                      "merchant": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "city": {
-                            "type": "string"
-                          },
-                          "country": {
-                            "type": "object",
-                            "properties": {
-                              "name": {
-                                "type": "string"
-                              },
-                              "numeric": {
-                                "type": "string"
-                              },
-                              "alpha2": {
-                                "type": "string"
-                              },
-                              "alpha3": {
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "name",
-                              "numeric",
-                              "alpha2",
-                              "alpha3"
-                            ]
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "city"
-                        ]
-                      },
-                      "billingAmount": {
-                        "type": "string"
-                      },
-                      "billingCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionAmount": {
-                        "type": "string"
-                      },
-                      "transactionCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionType": {
-                        "type": "string"
-                      },
-                      "cardToken": {
-                        "type": "string"
-                      },
-                      "impactsCashback": {
-                        "type": "boolean",
-                        "nullable": true
-                      },
-                      "transactions": {
-                        "type": "array",
-                        "items": {
-                          "type": "object",
-                          "properties": {
-                            "status": {
-                              "type": "string",
-                              "enum": [
-                                "Unsubmitted",
-                                "Unconfirmed",
-                                "ExecReverted",
-                                "ExecSuccess"
-                              ]
-                            },
-                            "to": {
-                              "type": "string"
-                            },
-                            "value": {
-                              "type": "string"
-                            },
-                            "data": {
-                              "type": "string"
-                            },
-                            "hash": {
-                              "type": "string",
-                              "nullable": true
-                            }
-                          },
-                          "required": [
-                            "status",
-                            "to",
-                            "value",
-                            "data"
-                          ]
-                        }
-                      },
-                      "kind": {
-                        "type": "string",
-                        "enum": [
-                          "Payment"
-                        ]
-                      },
-                      "status": {
-                        "type": "string",
-                        "enum": [
-                          "Approved",
-                          "IncorrectPin",
-                          "InsufficientFunds",
-                          "ExceedsApprovalAmountLimit",
-                          "InvalidAmount",
-                          "PinEntryTriesExceeded",
-                          "IncorrectSecurityCode",
-                          "Reversal",
-                          "PartialReversal",
-                          "Other"
-                        ]
-                      }
-                    },
-                    "required": [
-                      "threadId",
-                      "createdAt",
-                      "clearedAt",
-                      "isPending",
-                      "country",
-                      "mcc",
-                      "merchant",
-                      "billingAmount",
-                      "billingCurrency",
-                      "transactionAmount",
-                      "transactionCurrency",
-                      "transactionType",
-                      "cardToken",
-                      "transactions",
-                      "kind",
-                      "status"
-                    ]
-                  },
-                  {
-                    "type": "object",
-                    "properties": {
-                      "threadId": {
-                        "type": "string"
-                      },
-                      "createdAt": {
-                        "type": "string"
-                      },
-                      "clearedAt": {
-                        "type": "string",
-                        "nullable": true
-                      },
-                      "isPending": {
-                        "type": "boolean"
-                      },
-                      "country": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "numeric": {
-                            "type": "string"
-                          },
-                          "alpha2": {
-                            "type": "string"
-                          },
-                          "alpha3": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "numeric",
-                          "alpha2",
-                          "alpha3"
-                        ]
-                      },
-                      "mcc": {
-                        "type": "string"
-                      },
-                      "merchant": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "city": {
-                            "type": "string"
-                          },
-                          "country": {
-                            "type": "object",
-                            "properties": {
-                              "name": {
-                                "type": "string"
-                              },
-                              "numeric": {
-                                "type": "string"
-                              },
-                              "alpha2": {
-                                "type": "string"
-                              },
-                              "alpha3": {
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "name",
-                              "numeric",
-                              "alpha2",
-                              "alpha3"
-                            ]
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "city"
-                        ]
-                      },
-                      "billingAmount": {
-                        "type": "string"
-                      },
-                      "billingCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionAmount": {
-                        "type": "string"
-                      },
-                      "transactionCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionType": {
-                        "type": "string"
-                      },
-                      "cardToken": {
-                        "type": "string"
-                      },
-                      "impactsCashback": {
-                        "type": "boolean",
-                        "nullable": true
-                      },
-                      "transactions": {
-                        "type": "array",
-                        "items": {
-                          "type": "object",
-                          "properties": {
-                            "status": {
-                              "type": "string",
-                              "enum": [
-                                "Unsubmitted",
-                                "Unconfirmed",
-                                "ExecReverted",
-                                "ExecSuccess"
-                              ]
-                            },
-                            "to": {
-                              "type": "string"
-                            },
-                            "value": {
-                              "type": "string"
-                            },
-                            "data": {
-                              "type": "string"
-                            },
-                            "hash": {
-                              "type": "string",
-                              "nullable": true
-                            }
-                          },
-                          "required": [
-                            "status",
-                            "to",
-                            "value",
-                            "data"
-                          ]
-                        }
-                      },
-                      "kind": {
-                        "type": "string",
-                        "enum": [
-                          "Refund"
-                        ]
-                      },
-                      "refundAmount": {
-                        "type": "string"
-                      },
-                      "refundCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      }
-                    },
-                    "required": [
-                      "threadId",
-                      "createdAt",
-                      "clearedAt",
-                      "isPending",
-                      "country",
-                      "mcc",
-                      "merchant",
-                      "billingAmount",
-                      "billingCurrency",
-                      "transactionAmount",
-                      "transactionCurrency",
-                      "transactionType",
-                      "cardToken",
-                      "transactions",
-                      "kind",
-                      "refundAmount",
-                      "refundCurrency"
-                    ]
-                  },
-                  {
-                    "type": "object",
-                    "properties": {
-                      "threadId": {
-                        "type": "string"
-                      },
-                      "createdAt": {
-                        "type": "string"
-                      },
-                      "clearedAt": {
-                        "type": "string",
-                        "nullable": true
-                      },
-                      "isPending": {
-                        "type": "boolean"
-                      },
-                      "country": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "numeric": {
-                            "type": "string"
-                          },
-                          "alpha2": {
-                            "type": "string"
-                          },
-                          "alpha3": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "numeric",
-                          "alpha2",
-                          "alpha3"
-                        ]
-                      },
-                      "mcc": {
-                        "type": "string"
-                      },
-                      "merchant": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string"
-                          },
-                          "city": {
-                            "type": "string"
-                          },
-                          "country": {
-                            "type": "object",
-                            "properties": {
-                              "name": {
-                                "type": "string"
-                              },
-                              "numeric": {
-                                "type": "string"
-                              },
-                              "alpha2": {
-                                "type": "string"
-                              },
-                              "alpha3": {
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "name",
-                              "numeric",
-                              "alpha2",
-                              "alpha3"
-                            ]
-                          }
-                        },
-                        "required": [
-                          "name",
-                          "city"
-                        ]
-                      },
-                      "billingAmount": {
-                        "type": "string"
-                      },
-                      "billingCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionAmount": {
-                        "type": "string"
-                      },
-                      "transactionCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      },
-                      "transactionType": {
-                        "type": "string"
-                      },
-                      "cardToken": {
-                        "type": "string"
-                      },
-                      "impactsCashback": {
-                        "type": "boolean",
-                        "nullable": true
-                      },
-                      "transactions": {
-                        "type": "array",
-                        "items": {
-                          "type": "object",
-                          "properties": {
-                            "status": {
-                              "type": "string",
-                              "enum": [
-                                "Unsubmitted",
-                                "Unconfirmed",
-                                "ExecReverted",
-                                "ExecSuccess"
-                              ]
-                            },
-                            "to": {
-                              "type": "string"
-                            },
-                            "value": {
-                              "type": "string"
-                            },
-                            "data": {
-                              "type": "string"
-                            },
-                            "hash": {
-                              "type": "string",
-                              "nullable": true
-                            }
-                          },
-                          "required": [
-                            "status",
-                            "to",
-                            "value",
-                            "data"
-                          ]
-                        }
-                      },
-                      "kind": {
-                        "type": "string",
-                        "enum": [
-                          "Reversal"
-                        ]
-                      },
-                      "reversalAmount": {
-                        "type": "string"
-                      },
-                      "reversalCurrency": {
-                        "type": "object",
-                        "properties": {
-                          "symbol": {
-                            "type": "string"
-                          },
-                          "code": {
-                            "type": "string"
-                          },
-                          "decimals": {
-                            "type": "number"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "symbol",
-                          "code",
-                          "decimals",
-                          "name"
-                        ]
-                      }
-                    },
-                    "required": [
-                      "threadId",
-                      "createdAt",
-                      "clearedAt",
-                      "isPending",
-                      "country",
-                      "mcc",
-                      "merchant",
-                      "billingAmount",
-                      "billingCurrency",
-                      "transactionAmount",
-                      "transactionCurrency",
-                      "transactionType",
-                      "cardToken",
-                      "transactions",
-                      "kind",
-                      "reversalAmount",
-                      "reversalCurrency"
-                    ]
-                  }
-                ],
-                "example": {
-                  "event": {
-                    "kind": "Payment",
-                    "threadId": "thread_123456789",
-                    "createdAt": "2024-01-15T10:30:00.000Z",
-                    "clearedAt": "2024-01-15T10:35:00.000Z",
-                    "isPending": false,
-                    "country": {
-                      "name": "United States",
-                      "numeric": "840",
-                      "alpha2": "US",
-                      "alpha3": "USA"
-                    },
-                    "mcc": "5411",
-                    "merchant": {
-                      "name": "Grocery Store Inc",
-                      "city": "New York",
-                      "country": {
-                        "name": "United States",
-                        "numeric": "840",
-                        "alpha2": "US",
-                        "alpha3": "USA"
-                      }
-                    },
-                    "billingAmount": "5000",
-                    "billingCurrency": {
-                      "symbol": "$",
-                      "code": "840",
-                      "decimals": 2,
-                      "name": "US Dollar"
-                    },
-                    "transactionAmount": "5000",
-                    "transactionCurrency": {
-                      "symbol": "$",
-                      "code": "840",
-                      "decimals": 2,
-                      "name": "US Dollar"
-                    },
-                    "transactionType": "purchase",
-                    "cardToken": "card_token_abc123",
-                    "impactsCashback": true,
-                    "status": "Approved",
-                    "transactions": [
-                      {
-                        "status": "ExecSuccess",
-                        "to": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
-                        "value": "5000000000000000000",
-                        "data": "0x",
-                        "hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
-                      }
-                    ]
-                  }
-                },
-                "description": "Card transaction event"
-              }
-            },
-            "required": [
-              "userId",
-              "event"
-            ]
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when the transaction hash becomes available after broadcast.",
-        "example": {
-          "eventType": "card.transaction.declined",
-          "data": {
-            "userId": "user_123",
-            "event": {
-              "kind": "Payment",
-              "threadId": "thread_123456789",
-              "createdAt": "2024-01-15T10:30:00.000Z",
-              "clearedAt": "2024-01-15T10:35:00.000Z",
-              "isPending": false,
-              "country": {
-                "name": "United States",
-                "numeric": "840",
-                "alpha2": "US",
-                "alpha3": "USA"
-              },
-              "mcc": "5411",
-              "merchant": {
-                "name": "Grocery Store Inc",
-                "city": "New York",
-                "country": {
-                  "name": "United States",
-                  "numeric": "840",
-                  "alpha2": "US",
-                  "alpha3": "USA"
-                }
-              },
-              "billingAmount": "5000",
-              "billingCurrency": {
-                "symbol": "$",
-                "code": "840",
-                "decimals": 2,
-                "name": "US Dollar"
-              },
-              "transactionAmount": "5000",
-              "transactionCurrency": {
-                "symbol": "$",
-                "code": "840",
-                "decimals": 2,
-                "name": "US Dollar"
-              },
-              "transactionType": "purchase",
-              "cardToken": "card_token_abc123",
-              "impactsCashback": true,
-              "status": "Approved",
-              "transactions": [
-                {
-                  "status": "ExecSuccess",
-                  "to": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
-                  "value": "5000000000000000000",
-                  "data": "0x",
-                  "hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
-                }
-              ]
-            }
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "card.transaction.declined",
-  "data": {
-    "userId": "user_123",
-    "event": {
-      "kind": "Payment",
-      "threadId": "thread_123456789",
-      "createdAt": "2024-01-15T10:30:00.000Z",
-      "clearedAt": "2024-01-15T10:35:00.000Z",
-      "isPending": false,
-      "country": {
-        "name": "United States",
-        "numeric": "840",
-        "alpha2": "US",
-        "alpha3": "USA"
-      },
-      "mcc": "5411",
-      "merchant": {
-        "name": "Grocery Store Inc",
-        "city": "New York",
-        "country": {
-          "name": "United States",
-          "numeric": "840",
-          "alpha2": "US",
-          "alpha3": "USA"
-        }
-      },
-      "billingAmount": "5000",
-      "billingCurrency": {
-        "symbol": "$",
-        "code": "840",
-        "decimals": 2,
-        "name": "US Dollar"
-      },
-      "transactionAmount": "5000",
-      "transactionCurrency": {
-        "symbol": "$",
-        "code": "840",
-        "decimals": 2,
-        "name": "US Dollar"
-      },
-      "transactionType": "purchase",
-      "cardToken": "card_token_abc123",
-      "impactsCashback": true,
-      "status": "Approved",
-      "transactions": [
-        {
-          "status": "ExecSuccess",
-          "to": "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
-          "value": "5000000000000000000",
-          "data": "0x",
-          "hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
-        }
-      ]
-    }
-  }
-}
-```
-
-
-### physical.card.activated
-
-Triggered when a physical card is activated.
-
-**Event Type**: `physical.card.activated`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "physical.card.activated";
-  data: {
-    /** User ID */
-    userId: string;
-    /** Unique card token identifier */
-    cardToken: string;
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "physical.card.activated Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when a physical card is activated."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "physical.card.activated"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "userId": {
-                "type": "string",
-                "description": "User ID"
-              },
-              "cardToken": {
-                "type": "string",
-                "description": "Unique card token identifier"
-              }
-            },
-            "required": [
-              "userId",
-              "cardToken"
-            ],
-            "description": "Card token data",
-            "example": {
-              "userId": "user_123",
-              "cardToken": "card_123456789"
-            }
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when a physical card is activated.",
-        "example": {
-          "eventType": "physical.card.activated",
-          "data": {
-            "userId": "user_123",
-            "cardToken": "card_123456789"
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "physical.card.activated",
-  "data": {
-    "userId": "user_123",
-    "cardToken": "card_123456789"
-  }
-}
-```
-
-### physical.card.order.status.changed
-
-Triggered when the status of a physical card order changes.
-
-**Event Type**: `physical.card.order.status.changed`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "physical.card.order.status.changed";
-  data: {
-    /** User ID */
-    userId: string;
-    /** Card token */
-    cardToken: string;
-    /** Card order ID */
-    cardOrderId: string;
-    /** Previous order status */
-    oldStatus: string;
-    /** New order status */
-    newStatus: string;
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "physical.card.order.status.changed Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when the status of a physical card order changes."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "physical.card.order.status.changed"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "userId": {
-                "type": "string",
-                "description": "User ID"
-              },
-              "cardToken": {
-                "type": "string",
-                "description": "Card token"
-              },
-              "cardOrderId": {
-                "type": "string",
-                "description": "Card order ID"
-              },
-              "oldStatus": {
-                "type": "string",
-                "description": "Previous order status"
-              },
-              "newStatus": {
-                "type": "string",
-                "description": "New order status"
-              }
-            },
-            "required": [
-              "userId",
-              "cardToken",
-              "cardOrderId",
-              "oldStatus",
-              "newStatus"
-            ],
-            "description": "Physical card order status change data",
-            "example": {
-              "userId": "user_123",
-              "cardToken": "card_123",
-              "cardOrderId": "order_456",
-              "oldStatus": "ordered",
-              "newStatus": "shipped"
-            }
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when the status of a physical card order changes.",
-        "example": {
-          "eventType": "physical.card.order.status.changed",
-          "data": {
-            "userId": "user_123",
-            "cardToken": "card_123",
-            "cardOrderId": "order_456",
-            "oldStatus": "ordered",
-            "newStatus": "shipped"
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "physical.card.order.status.changed",
-  "data": {
-    "userId": "user_123",
-    "cardToken": "card_123",
-    "cardOrderId": "order_456",
-    "oldStatus": "ordered",
-    "newStatus": "shipped"
-  }
-}
-```
-
-### physical.card.ordered
-
-Triggered when a physical card is ordered.
-
-**Event Type**: `physical.card.ordered`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "physical.card.ordered";
-  data: {
-    /** User ID */
-    userId: string;
-    /** Card token */
-    cardToken: string;
-    /** Card order ID */
-    id: string;
-    /** Order status */
-    status: string;
-    /** Name to emboss on card */
-    embossedName: string;
-    /** Primary address */
-    address1: string;
-    /** Secondary address */
-    address2: string;
-    /** City */
-    city: string;
-    /** Postal code */
-    postalCode: string;
-    /** State */
-    state: string;
-    /** Country */
-    country: string;
-    /** Phone number */
-    phone: string;
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "physical.card.ordered Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when a physical card is ordered."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "physical.card.ordered"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "userId": {
-                "type": "string",
-                "description": "User ID"
-              },
-              "cardToken": {
-                "type": "string",
-                "description": "Card token"
-              },
-              "id": {
-                "type": "string",
-                "description": "Card order ID"
-              },
-              "status": {
-                "type": "string",
-                "description": "Order status"
-              },
-              "embossedName": {
-                "type": "string",
-                "description": "Name to emboss on card"
-              },
-              "address1": {
-                "type": "string",
-                "nullable": true,
-                "description": "Primary address"
-              },
-              "address2": {
-                "type": "string",
-                "nullable": true,
-                "description": "Secondary address"
-              },
-              "city": {
-                "type": "string",
-                "nullable": true,
-                "description": "City"
-              },
-              "postalCode": {
-                "type": "string",
-                "nullable": true,
-                "description": "Postal code"
-              },
-              "state": {
-                "type": "string",
-                "nullable": true,
-                "description": "State"
-              },
-              "country": {
-                "type": "string",
-                "nullable": true,
-                "description": "Country"
-              },
-              "phone": {
-                "type": "string",
-                "nullable": true,
-                "description": "Phone number"
-              }
-            },
-            "required": [
-              "userId",
-              "cardToken",
-              "id",
-              "status",
-              "embossedName",
-              "address1",
-              "address2",
-              "city",
-              "postalCode",
-              "state",
-              "country",
-              "phone"
-            ],
-            "description": "Physical card order data",
-            "example": {
-              "userId": "user_123",
-              "cardToken": "card_123",
-              "id": "order_456",
-              "status": "ordered",
-              "embossedName": "John Doe",
-              "address1": "123 Main Street",
-              "address2": "Apt 4B",
-              "city": "New York",
-              "postalCode": "10001",
-              "state": "NY",
-              "country": "US",
-              "phone": "+1234567890"
-            }
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when a physical card is ordered.",
-        "example": {
-          "eventType": "physical.card.ordered",
-          "data": {
-            "userId": "user_123",
-            "cardToken": "card_123",
-            "id": "order_456",
-            "status": "ordered",
-            "embossedName": "John Doe",
-            "address1": "123 Main Street",
-            "address2": "Apt 4B",
-            "city": "New York",
-            "postalCode": "10001",
-            "state": "NY",
-            "country": "US",
-            "phone": "+1234567890"
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "physical.card.ordered",
-  "data": {
-    "userId": "user_123",
-    "cardToken": "card_123",
-    "id": "order_456",
-    "status": "ordered",
-    "embossedName": "John Doe",
-    "address1": "123 Main Street",
-    "address2": "Apt 4B",
-    "city": "New York",
-    "postalCode": "10001",
-    "state": "NY",
-    "country": "US",
-    "phone": "+1234567890"
-  }
-}
-```
-
-### physical.card.pin.changed
-
-Triggered when a physical card's PIN is changed.
-
-**Event Type**: `physical.card.pin.changed`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "physical.card.pin.changed";
-  data: {
-    /** User ID */
-    userId: string;
-    /** Unique card token identifier */
-    cardToken: string;
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "physical.card.pin.changed Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when a physical card's PIN is changed."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "physical.card.pin.changed"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "userId": {
-                "type": "string",
-                "description": "User ID"
-              },
-              "cardToken": {
-                "type": "string",
-                "description": "Unique card token identifier"
-              }
-            },
-            "required": [
-              "userId",
-              "cardToken"
-            ],
-            "description": "Card token data",
-            "example": {
-              "userId": "user_123",
-              "cardToken": "card_123456789"
-            }
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when a physical card's PIN is changed.",
-        "example": {
-          "eventType": "physical.card.pin.changed",
-          "data": {
-            "userId": "user_123",
-            "cardToken": "card_123456789"
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "physical.card.pin.changed",
-  "data": {
-    "userId": "user_123",
-    "cardToken": "card_123456789"
-  }
-}
-```
-
-### virtual.card.issued
-
-Triggered when a virtual card is issued.
-
-**Event Type**: `virtual.card.issued`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "virtual.card.issued";
-  data: {
-    /** Card ID */
-    id: string;
-    /** Unique card token identifier */
-    cardToken: string;
-    /** User ID */
-    userId: string;
-    /** Last four digits of the card */
-    lastFourDigits: string;
-    /** When the card was activated (ISO 8601) */
-    activatedAt: string | null;
-    /** True for virtual cards, false for physical */
-    virtual: boolean;
-    /** Card status code from payment processor (e.g. 1000 = Active) */
-    statusCode: number;
-    /** Human-readable card status (e.g. Active, Frozen, Void) */
-    statusName: string;
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "virtual.card.issued Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when a virtual card is issued."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "virtual.card.issued"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "id": {
-                "type": "string",
-                "description": "Card ID"
-              },
-              "cardToken": {
-                "type": "string",
-                "description": "Unique card token identifier"
-              },
-              "userId": {
-                "type": "string",
-                "description": "User ID"
-              },
-              "lastFourDigits": {
-                "type": "string",
-                "description": "Last four digits of the card"
-              },
-              "activatedAt": {
-                "type": "string",
-                "format": "date-time",
-                "nullable": true,
-                "description": "When the card was activated (ISO 8601)"
-              },
-              "virtual": {
-                "type": "boolean",
-                "description": "True for virtual cards, false for physical"
-              },
-              "statusCode": {
-                "type": "number",
-                "description": "Card status code from payment processor (e.g. 1000 = Active)"
-              },
-              "statusName": {
-                "type": "string",
-                "description": "Human-readable card status (e.g. Active, Frozen, Void)"
-              }
-            },
-            "required": [
-              "id",
-              "cardToken",
-              "userId",
-              "lastFourDigits",
-              "activatedAt",
-              "virtual",
-              "statusCode",
-              "statusName"
-            ],
-            "description": "Card data payload for card-related webhook events.",
-            "example": {
-              "id": "card_abc123",
-              "userId": "user_123",
-              "cardToken": "card_123456789",
-              "lastFourDigits": "4242",
-              "activatedAt": "2024-01-15T10:30:00Z",
-              "virtual": true,
-              "statusCode": 1000,
-              "statusName": "Active"
-            }
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when a virtual card is issued.",
-        "example": {
-          "eventType": "virtual.card.issued",
-          "data": {
-            "id": "card_abc123",
-            "userId": "user_123",
-            "cardToken": "card_123456789",
-            "lastFourDigits": "4242",
-            "activatedAt": "2024-01-15T10:30:00Z",
-            "virtual": true,
-            "statusCode": 1000,
-            "statusName": "Active"
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "virtual.card.issued",
-  "data": {
-    "id": "card_abc123",
-    "userId": "user_123",
-    "cardToken": "card_123456789",
-    "lastFourDigits": "4242",
-    "activatedAt": "2024-01-15T10:30:00Z",
-    "virtual": true,
-    "statusCode": 1000,
-    "statusName": "Active"
-  }
-}
-```
-
-## Account Events
-
-### account.balance.changed
-
-Triggered when an account's balance changes.
-
-**Event Type**: `account.balance.changed`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "account.balance.changed";
-  data: {
-    /** User ID */
-    userId: string;
-    /** Total balance in wei */
-    total: number;
-    /** Spendable balance in wei */
-    spendable: number;
-    /** Pending balance in wei */
-    pending: number;
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "account.balance.changed Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when an account's balance changes."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "account.balance.changed"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "userId": {
-                "type": "string",
-                "description": "User ID"
-              },
-              "total": {
-                "type": "number",
-                "description": "Total balance in wei"
-              },
-              "spendable": {
-                "type": "number",
-                "description": "Spendable balance in wei"
-              },
-              "pending": {
-                "type": "number",
-                "description": "Pending balance in wei"
-              }
-            },
-            "required": [
-              "userId",
-              "total",
-              "spendable",
-              "pending"
-            ],
-            "description": "Account balance change data",
-            "example": {
-              "userId": "user_123",
-              "total": 1000000000000000000,
-              "spendable": 800000000000000000,
-              "pending": 200000000000000000
-            }
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when an account's balance changes.",
-        "example": {
-          "eventType": "account.balance.changed",
-          "data": {
-            "userId": "user_123",
-            "total": 1000000000000000000,
-            "spendable": 800000000000000000,
-            "pending": 200000000000000000
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "account.balance.changed",
-  "data": {
-    "userId": "user_123",
-    "total": 1000000000000000000,
-    "spendable": 800000000000000000,
-    "pending": 200000000000000000
-  }
-}
-```
-
-### account.limit.changed
-
-Triggered when an account's limit changes.
-
-**Event Type**: `account.limit.changed`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "account.limit.changed";
-  data: {
-    /** User ID */
-    userId: string;
-    /** Previous account limit */
-    oldLimit: number;
-    /** New account limit */
-    newLimit: number;
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "account.limit.changed Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when an account's limit changes."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "account.limit.changed"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "userId": {
-                "type": "string",
-                "description": "User ID"
-              },
-              "oldLimit": {
-                "type": "number",
-                "description": "Previous account limit"
-              },
-              "newLimit": {
-                "type": "number",
-                "description": "New account limit"
-              }
-            },
-            "required": [
-              "userId",
-              "oldLimit",
-              "newLimit"
-            ],
-            "description": "Account limit change data",
-            "example": {
-              "userId": "user_123",
-              "oldLimit": 1000,
-              "newLimit": 2000
-            }
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when an account's limit changes.",
-        "example": {
-          "eventType": "account.limit.changed",
-          "data": {
-            "userId": "user_123",
-            "oldLimit": 1000,
-            "newLimit": 2000
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "account.limit.changed",
-  "data": {
-    "userId": "user_123",
-    "oldLimit": 1000,
-    "newLimit": 2000
-  }
-}
-```
-
-### account.withdrawal.completed
-
-Triggered when an account withdrawal is completed.
-
-**Event Type**: `account.withdrawal.completed`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "account.withdrawal.completed";
-  data: {
-    /** Transaction ID */
-    id: string;
-    /** Safe address */
-    safeAddress: string;
-    /** Transaction data */
-    transactionData: string;
-    /** Enqueue task ID */
-    enqueueTaskId: string;
-    /** Dispatch task ID */
-    dispatchTaskId: string;
-    /** Ready timestamp */
-    readyAt: string;
-    /** Operation type for delay transaction */
-    operationType: "CALL" | "DELEGATECALL";
-    /** User ID */
-    userId: string;
-    /** Delay transaction status */
-    status: "QUEUING" | "WAITING" | "EXECUTING" | "EXECUTED" | "FAILED";
-    /** Creation timestamp */
-    createdAt: string;
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "account.withdrawal.completed Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when an account withdrawal is completed."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "account.withdrawal.completed"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "id": {
-                "type": "string",
-                "description": "Transaction ID"
-              },
-              "safeAddress": {
-                "type": "string",
-                "description": "Safe address"
-              },
-              "transactionData": {
-                "type": "string",
-                "description": "Transaction data"
-              },
-              "enqueueTaskId": {
-                "type": "string",
-                "description": "Enqueue task ID"
-              },
-              "dispatchTaskId": {
-                "type": "string",
-                "nullable": true,
-                "description": "Dispatch task ID"
-              },
-              "readyAt": {
-                "type": "string",
-                "nullable": true,
-                "format": "date",
-                "description": "Ready timestamp"
-              },
-              "operationType": {
-                "type": "string",
-                "nullable": true,
-                "enum": [
-                  "CALL",
-                  "DELEGATECALL"
-                ],
-                "description": "Operation type for delay transaction",
-                "example": "CALL"
-              },
-              "userId": {
-                "type": "string",
-                "description": "User ID"
-              },
-              "status": {
-                "type": "string",
-                "enum": [
-                  "QUEUING",
-                  "WAITING",
-                  "EXECUTING",
-                  "EXECUTED",
-                  "FAILED"
-                ],
-                "description": "Delay transaction status",
-                "example": "EXECUTED"
-              },
-              "createdAt": {
-                "type": "string",
-                "format": "date",
-                "description": "Creation timestamp"
-              }
-            },
-            "required": [
-              "id",
-              "safeAddress",
-              "transactionData",
-              "enqueueTaskId",
-              "dispatchTaskId",
-              "readyAt",
-              "operationType",
-              "userId",
-              "status",
-              "createdAt"
-            ],
-            "description": "Delay transaction data",
-            "example": {
-              "id": "tx_123",
-              "safeAddress": "0x123...",
-              "transactionData": "0x456...",
-              "enqueueTaskId": "task_789",
-              "dispatchTaskId": "task_101",
-              "readyAt": "2025-10-15T08:00:24.194Z",
-              "operationType": "CALL",
-              "userId": "user_123",
-              "status": "EXECUTED",
-              "createdAt": "2025-10-15T08:00:24.194Z"
-            }
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when an account withdrawal is completed.",
-        "example": {
-          "eventType": "account.withdrawal.completed",
-          "data": {
-            "id": "tx_123",
-            "safeAddress": "0x123...",
-            "transactionData": "0x456...",
-            "enqueueTaskId": "task_789",
-            "dispatchTaskId": "task_101",
-            "readyAt": "2025-10-15T08:00:24.194Z",
-            "operationType": "CALL",
-            "userId": "user_123",
-            "status": "EXECUTED",
-            "createdAt": "2025-10-15T08:00:24.194Z"
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "account.withdrawal.completed",
-  "data": {
-    "id": "tx_123",
-    "safeAddress": "0x123...",
-    "transactionData": "0x456...",
-    "enqueueTaskId": "task_789",
-    "dispatchTaskId": "task_101",
-    "readyAt": "2025-10-15T08:00:24.194Z",
-    "operationType": "CALL",
-    "userId": "user_123",
-    "status": "EXECUTED",
-    "createdAt": "2025-10-15T08:00:24.194Z"
-  }
-}
-```
-
-### account.withdrawal.failed
-
-Triggered when an account withdrawal fails.
-
-**Event Type**: `account.withdrawal.failed`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "account.withdrawal.failed";
-  data: {
-    /** User ID */
-    userId: string;
-    /** Error message */
-    error: string;
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "account.withdrawal.failed Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when an account withdrawal fails."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "account.withdrawal.failed"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "userId": {
-                "type": "string",
-                "description": "User ID"
-              },
-              "error": {
-                "type": "string",
-                "description": "Error message"
-              }
-            },
-            "required": [
-              "userId",
-              "error"
-            ],
-            "description": "Error data",
-            "example": {
-              "userId": "user_123",
-              "error": "Transaction failed"
-            }
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when an account withdrawal fails.",
-        "example": {
-          "eventType": "account.withdrawal.failed",
-          "data": {
-            "userId": "user_123",
-            "error": "Transaction failed"
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "account.withdrawal.failed",
-  "data": {
-    "userId": "user_123",
-    "error": "Transaction failed"
-  }
-}
-```
-
-## Banking Events
-
-### iban.created
-
-Triggered when an IBAN is created for a user.
-
-**Event Type**: `iban.created`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "iban.created";
-  data: {
-    /** User ID */
-    userId: string;
-    /** International Bank Account Number */
-    iban: string;
-    /** Bank Identifier Code */
-    bic: string;
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "iban.created Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when an IBAN is created for a user."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "iban.created"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "userId": {
-                "type": "string",
-                "description": "User ID"
-              },
-              "iban": {
-                "type": "string",
-                "description": "International Bank Account Number"
-              },
-              "bic": {
-                "type": "string",
-                "description": "Bank Identifier Code"
-              }
-            },
-            "required": [
-              "userId",
-              "iban",
-              "bic"
-            ],
-            "description": "IBAN data",
-            "example": {
-              "userId": "user_123",
-              "iban": "GB82WEST12345698765432",
-              "bic": "WESTGB22"
-            }
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when an IBAN is created for a user.",
-        "example": {
-          "eventType": "iban.created",
-          "data": {
-            "userId": "user_123",
-            "iban": "GB82WEST12345698765432",
-            "bic": "WESTGB22"
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "iban.created",
-  "data": {
-    "userId": "user_123",
-    "iban": "GB82WEST12345698765432",
-    "bic": "WESTGB22"
-  }
-}
-```
-
-### iban.status.changed
-
-Triggered when an IBAN's status changes.
-
-**Event Type**: `iban.status.changed`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "iban.status.changed";
-  data: {
-    /** User ID */
-    userId: string;
-    /** IBAN status */
-    previousStatus: "NOTSTARTED" | "PENDING" | "PENDING_OAUTH" | "ASSIGNED";
-    /** IBAN status */
-    currentStatus: "NOTSTARTED" | "PENDING" | "PENDING_OAUTH" | "ASSIGNED";
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "iban.status.changed Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when an IBAN's status changes."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "iban.status.changed"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "userId": {
-                "type": "string",
-                "description": "User ID"
-              },
-              "previousStatus": {
-                "type": "string",
-                "enum": [
-                  "NOTSTARTED",
-                  "PENDING",
-                  "PENDING_OAUTH",
-                  "ASSIGNED"
-                ],
-                "description": "IBAN status",
-                "example": "ASSIGNED"
-              },
-              "currentStatus": {
-                "type": "string",
-                "enum": [
-                  "NOTSTARTED",
-                  "PENDING",
-                  "PENDING_OAUTH",
-                  "ASSIGNED"
-                ],
-                "description": "IBAN status",
-                "example": "ASSIGNED"
-              }
-            },
-            "required": [
-              "userId",
-              "previousStatus",
-              "currentStatus"
-            ],
-            "description": "IBAN status change data",
-            "example": {
-              "userId": "user_123",
-              "previousStatus": "PENDING",
-              "currentStatus": "ASSIGNED"
-            }
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when an IBAN's status changes.",
-        "example": {
-          "eventType": "iban.status.changed",
-          "data": {
-            "userId": "user_123",
-            "previousStatus": "PENDING",
-            "currentStatus": "ASSIGNED"
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "iban.status.changed",
-  "data": {
-    "userId": "user_123",
-    "previousStatus": "PENDING",
-    "currentStatus": "ASSIGNED"
-  }
-}
-```
-
-## Safe Wallet Events
-
-### safe.created
-
-Triggered when a Safe wallet is created.
-
-**Event Type**: `safe.created`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "safe.created";
-  data: {
-    /** Safe account ID */
-    id: string;
-    /** Safe account address */
-    address: string;
-    /** Account salt */
-    salt: string;
-    /** Blockchain chain ID */
-    chainId: string;
-    /** User ID */
-    userId: string;
-    /** Token symbol */
-    tokenSymbol: "GBPe" | "EURe" | "USDCe";
-    /** Creation timestamp */
-    createdAt: string;
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "safe.created Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when a Safe wallet is created."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "safe.created"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "id": {
-                "type": "string",
-                "description": "Safe account ID"
-              },
-              "address": {
-                "type": "string",
-                "description": "Safe account address"
-              },
-              "salt": {
-                "type": "string",
-                "nullable": true,
-                "description": "Account salt"
-              },
-              "chainId": {
-                "type": "string",
-                "nullable": true,
-                "description": "Blockchain chain ID"
-              },
-              "userId": {
-                "type": "string",
-                "description": "User ID"
-              },
-              "tokenSymbol": {
-                "type": "string",
-                "nullable": true,
-                "enum": [
-                  "GBPe",
-                  "EURe",
-                  "USDCe"
-                ],
-                "description": "Token symbol",
-                "example": "EURe"
-              },
-              "createdAt": {
-                "type": "string",
-                "description": "Creation timestamp"
-              }
-            },
-            "required": [
-              "id",
-              "address",
-              "salt",
-              "chainId",
-              "userId",
-              "tokenSymbol",
-              "createdAt"
-            ],
-            "description": "Safe account data",
-            "example": {
-              "id": "safe_123",
-              "address": "0x456...",
-              "salt": "salt_123",
-              "chainId": "100",
-              "userId": "user_123",
-              "tokenSymbol": "EURe",
-              "createdAt": "2025-10-15T08:00:24.193Z"
-            }
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when a Safe wallet is created.",
-        "example": {
-          "eventType": "safe.created",
-          "data": {
-            "id": "safe_123",
-            "address": "0x456...",
-            "salt": "salt_123",
-            "chainId": "100",
-            "userId": "user_123",
-            "tokenSymbol": "EURe",
-            "createdAt": "2025-10-15T08:00:24.193Z"
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "safe.created",
-  "data": {
-    "id": "safe_123",
-    "address": "0x456...",
-    "salt": "salt_123",
-    "chainId": "100",
-    "userId": "user_123",
-    "tokenSymbol": "EURe",
-    "createdAt": "2025-10-15T08:00:24.193Z"
-  }
-}
-```
-
-### safe.currency.updated
-
-Triggered when a Safe's currency is updated.
-
-**Event Type**: `safe.currency.updated`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "safe.currency.updated";
-  data: {
-    /** Safe account ID */
-    id: string;
-    /** Safe account address */
-    address: string;
-    /** Account salt */
-    salt: string;
-    /** Blockchain chain ID */
-    chainId: string;
-    /** User ID */
-    userId: string;
-    /** Token symbol */
-    tokenSymbol: "GBPe" | "EURe" | "USDCe";
-    /** Creation timestamp */
-    createdAt: string;
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "safe.currency.updated Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when a Safe's currency is updated."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "safe.currency.updated"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "id": {
-                "type": "string",
-                "description": "Safe account ID"
-              },
-              "address": {
-                "type": "string",
-                "description": "Safe account address"
-              },
-              "salt": {
-                "type": "string",
-                "nullable": true,
-                "description": "Account salt"
-              },
-              "chainId": {
-                "type": "string",
-                "nullable": true,
-                "description": "Blockchain chain ID"
-              },
-              "userId": {
-                "type": "string",
-                "description": "User ID"
-              },
-              "tokenSymbol": {
-                "type": "string",
-                "nullable": true,
-                "enum": [
-                  "GBPe",
-                  "EURe",
-                  "USDCe"
-                ],
-                "description": "Token symbol",
-                "example": "EURe"
-              },
-              "createdAt": {
-                "type": "string",
-                "description": "Creation timestamp"
-              }
-            },
-            "required": [
-              "id",
-              "address",
-              "salt",
-              "chainId",
-              "userId",
-              "tokenSymbol",
-              "createdAt"
-            ],
-            "description": "Safe account data",
-            "example": {
-              "id": "safe_123",
-              "address": "0x456...",
-              "salt": "salt_123",
-              "chainId": "100",
-              "userId": "user_123",
-              "tokenSymbol": "EURe",
-              "createdAt": "2025-10-15T08:00:24.193Z"
-            }
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when a Safe's currency is updated.",
-        "example": {
-          "eventType": "safe.currency.updated",
-          "data": {
-            "id": "safe_123",
-            "address": "0x456...",
-            "salt": "salt_123",
-            "chainId": "100",
-            "userId": "user_123",
-            "tokenSymbol": "EURe",
-            "createdAt": "2025-10-15T08:00:24.193Z"
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "safe.currency.updated",
-  "data": {
-    "id": "safe_123",
-    "address": "0x456...",
-    "salt": "salt_123",
-    "chainId": "100",
-    "userId": "user_123",
-    "tokenSymbol": "EURe",
-    "createdAt": "2025-10-15T08:00:24.193Z"
-  }
-}
-```
-
-### safe.modules.deployed
-
-Triggered when Safe modules are deployed.
-
-**Event Type**: `safe.modules.deployed`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "safe.modules.deployed";
-  data: {
-    /** Safe account ID */
-    id: string;
-    /** Safe account address */
-    address: string;
-    /** Account salt */
-    salt: string;
-    /** Blockchain chain ID */
-    chainId: string;
-    /** User ID */
-    userId: string;
-    /** Token symbol */
-    tokenSymbol: "GBPe" | "EURe" | "USDCe";
-    /** Creation timestamp */
-    createdAt: string;
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "safe.modules.deployed Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when Safe modules are deployed."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "safe.modules.deployed"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "id": {
-                "type": "string",
-                "description": "Safe account ID"
-              },
-              "address": {
-                "type": "string",
-                "description": "Safe account address"
-              },
-              "salt": {
-                "type": "string",
-                "nullable": true,
-                "description": "Account salt"
-              },
-              "chainId": {
-                "type": "string",
-                "nullable": true,
-                "description": "Blockchain chain ID"
-              },
-              "userId": {
-                "type": "string",
-                "description": "User ID"
-              },
-              "tokenSymbol": {
-                "type": "string",
-                "nullable": true,
-                "enum": [
-                  "GBPe",
-                  "EURe",
-                  "USDCe"
-                ],
-                "description": "Token symbol",
-                "example": "EURe"
-              },
-              "createdAt": {
-                "type": "string",
-                "description": "Creation timestamp"
-              }
-            },
-            "required": [
-              "id",
-              "address",
-              "salt",
-              "chainId",
-              "userId",
-              "tokenSymbol",
-              "createdAt"
-            ],
-            "description": "Safe account data",
-            "example": {
-              "id": "safe_123",
-              "address": "0x456...",
-              "salt": "salt_123",
-              "chainId": "100",
-              "userId": "user_123",
-              "tokenSymbol": "EURe",
-              "createdAt": "2025-10-15T08:00:24.193Z"
-            }
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when Safe modules are deployed.",
-        "example": {
-          "eventType": "safe.modules.deployed",
-          "data": {
-            "id": "safe_123",
-            "address": "0x456...",
-            "salt": "salt_123",
-            "chainId": "100",
-            "userId": "user_123",
-            "tokenSymbol": "EURe",
-            "createdAt": "2025-10-15T08:00:24.193Z"
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "safe.modules.deployed",
-  "data": {
-    "id": "safe_123",
-    "address": "0x456...",
-    "salt": "salt_123",
-    "chainId": "100",
-    "userId": "user_123",
-    "tokenSymbol": "EURe",
-    "createdAt": "2025-10-15T08:00:24.193Z"
-  }
-}
-```
-
-### safe.owner.added
-
-Triggered when an owner is added to a Safe.
-
-**Event Type**: `safe.owner.added`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "safe.owner.added";
-  data: {
-    /** User ID */
-    userId: string;
-    /** Current owner address */
-    owner: string;
-    /** Safe address */
-    safeAddress: string;
-    /** Newly added owner address */
-    addedOwner: string;
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "safe.owner.added Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when an owner is added to a Safe."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "safe.owner.added"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "userId": {
-                "type": "string",
-                "description": "User ID"
-              },
-              "owner": {
-                "type": "string",
-                "description": "Current owner address"
-              },
-              "safeAddress": {
-                "type": "string",
-                "description": "Safe address"
-              },
-              "addedOwner": {
-                "type": "string",
-                "description": "Newly added owner address"
-              }
-            },
-            "required": [
-              "userId",
-              "owner",
-              "safeAddress",
-              "addedOwner"
-            ],
-            "description": "Safe owner added data",
-            "example": {
-              "userId": "user_123",
-              "owner": "0x123...",
-              "safeAddress": "0x456...",
-              "addedOwner": "0x789..."
-            }
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when an owner is added to a Safe.",
-        "example": {
-          "eventType": "safe.owner.added",
-          "data": {
-            "userId": "user_123",
-            "owner": "0x123...",
-            "safeAddress": "0x456...",
-            "addedOwner": "0x789..."
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "safe.owner.added",
-  "data": {
-    "userId": "user_123",
-    "owner": "0x123...",
-    "safeAddress": "0x456...",
-    "addedOwner": "0x789..."
-  }
-}
-```
-
-### safe.owner.removed
-
-Triggered when an owner is removed from a Safe.
-
-**Event Type**: `safe.owner.removed`
-
-**Schema Definition**:
-
-<CodeGroup>
-```typescript TypeScript
-{
-  eventType: "safe.owner.removed";
-  data: {
-    /** User ID */
-    userId: string;
-    safeAddress: string;
-    removedOwner: string;
-  };
-}
-```
-```json OpenAPI Schema
-{
-  "openapi": "3.0.0",
-  "info": {
-    "title": "safe.owner.removed Webhook Event",
-    "version": "1.0.0",
-    "description": "Triggered when an owner is removed from a Safe."
-  },
-  "components": {
-    "schemas": {
-      "WebhookEvent": {
-        "type": "object",
-        "properties": {
-          "eventType": {
-            "type": "string",
-            "enum": [
-              "safe.owner.removed"
-            ]
-          },
-          "data": {
-            "type": "object",
-            "properties": {
-              "userId": {
-                "type": "string",
-                "description": "User ID"
-              },
-              "safeAddress": {
-                "type": "string"
-              },
-              "removedOwner": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "userId",
-              "safeAddress",
-              "removedOwner"
-            ]
-          }
-        },
-        "required": [
-          "eventType",
-          "data"
-        ],
-        "description": "Triggered when an owner is removed from a Safe.",
-        "example": {
-          "eventType": "safe.owner.removed",
-          "data": {
-            "userId": "user_123",
-            "safeAddress": "0x456...",
-            "removedOwner": "0x789..."
-          }
-        }
-      }
-    }
-  }
-}
-```
-</CodeGroup>
-
-**Example**:
-
-```json
-{
-  "eventType": "safe.owner.removed",
-  "data": {
-    "userId": "user_123",
-    "safeAddress": "0x456...",
-    "removedOwner": "0x789..."
-  }
-}
-```
diff --git a/webhooks/getting-started.mdx b/webhooks/getting-started.mdx
deleted file mode 100644
index d22e22a..0000000
--- a/webhooks/getting-started.mdx
+++ /dev/null
@@ -1,177 +0,0 @@
----
-title: "Working with Webhooks"
-description: "Step-by-step guide to set up and implement webhooks in your application."
----
-
-## Guidelines
-
-To implement webhooks in your application, follow these essential steps:
-
-<Steps titleSize="h3">
-<Step title="Configure Your Endpoint">
-Create a publicly accessible HTTP endpoint in your application that can receive POST requests. This endpoint must be available over HTTPS and return a 2xx status code to acknowledge receipt of webhook events.
-
-<Warning>
-Your webhook endpoint must be publicly accessible. For local development, use tools like [ngrok](https://ngrok.com/) to expose your local server.
-</Warning>
-</Step>
-
-<Step title="Configure Webhooks">
-Configure your webhook endpoint URL directly through the [Partners Dashboard](https://partners.gnosispay.com/) or contact your Gnosis Pay partner manager for assistance. Provide the complete HTTPS URL where you want to receive webhook notifications.
-
-<Info>
-**Partners Dashboard**: For partners registered through the dashboard, webhook configuration is available instantly in your dashboard settings.
-**Manual Setup**: If you need technical support assistance, webhook configuration typically takes 1-2 business days.
-</Info>
-</Step>
-
-<Step title="Receive and Verify Events">
-When events happen in the Gnosis Pay system, we'll send HTTP POST requests to your webhook endpoint with event data and cryptographic signatures.
-
-All webhooks include cryptographic signatures using **Ed25519 asymmetric cryptography**:
-
-- **`X-Webhook-Timestamp`**: Unix timestamp when the webhook was sent
-- **`X-Webhook-Signature`**: Base64-encoded Ed25519 signature
-
-<Warning>
-  **Always verify webhook signatures** before processing events. This ensures
-  the webhook originated from Gnosis Pay and hasn't been tampered with.
-</Warning>
-
-Retrieve the public key for signature verification from our API:
-
-```bash cURL
-curl -X GET https://webhooks.gnosispay.com/api/v1/public-key
-```
-
-</Step>
-
-<Step title="Parse and Process Event Data">
-Extract the `eventType` and `data` fields from the webhook payload. The `eventType` identifies what happened (e.g., `user.created`, `kyc.status.changed`), while `data` contains the complete entity information.
-
-```json
-{
-  "eventType": "user.created",
-  "data": {
-    "id": "user_123",
-    "email": "user@example.com",
-    // ... complete user entity
-  }
-}
-```
-
-Handle each event type appropriately in your application. Since we send complete entity data, you typically won't need additional API calls to get the full context.
-
-<Info>
-Process events idempotently to handle potential duplicates, and implement proper error handling and logging for monitoring.
-</Info>
-
-<Info>
-  **Retry Policy**: If your webhook endpoint returns a non-2xx status code, we'll retry delivery up to 3 times with exponential backoff (1 minute, 5 minutes, 15 minutes).
-</Info>
-
-<Warning>
-  **Timeout**: Your webhook endpoint must respond within 30 seconds. Requests that exceed this timeout are considered failed and will trigger our retry mechanism.
-</Warning>
-
-</Step>
-</Steps> 
-
-## Complete Example
-
-<CodeGroup>
-
-```typescript Node.js
-import express from "express";
-import crypto from "crypto";
-
-const app = express();
-
-// Use raw body parsing for webhook signature verification
-app.use("/webhook", express.raw({ type: "application/json" }));
-app.use(express.json());
-
-app.post("/webhook", async (req: express.Request, res: express.Response) => {
-  try {
-    // Verify the webhook signature
-    const isValid = await verifyWebhookSignature(req);
-    if (!isValid) {
-      return res.status(401).send("Invalid signature");
-    }
-
-    // Parse the body after verification
-    const payload = JSON.parse(req.body.toString());
-    const { eventType, data } = payload;
-    await processWebhookEvent(eventType, data);
-
-    // Acknowledge receipt
-    res.status(200).send("OK");
-  } catch (error) {
-    console.error("Webhook processing error:", error);
-    res.status(500).send("Internal server error");
-  }
-});
-
-async function verifyWebhookSignature(req: express.Request): Promise<boolean> {
-  try {
-    const signature = req.headers["x-webhook-signature"] as string;
-    const timestamp = req.headers["x-webhook-timestamp"] as string;
-
-    // Check if required headers are present
-    if (!timestamp || !signature) {
-      console.error(
-        "Missing required headers: x-webhook-timestamp or x-webhook-signature"
-      );
-      return false;
-    }
-
-    // Use the raw body for signature verification
-    const body = req.body.toString();
-
-    // Retrieve the public key from Gnosis Pay
-    const publicKeyResponse = await fetch(
-      "https://webhooks.gnosispay.com/api/v1/public-key"
-    );
-    const keyData = await publicKeyResponse.json();
-
-    if (!keyData.success || !keyData.publicKey) {
-      throw new Error("Failed to fetch public key");
-    }
-
-    const { publicKey } = keyData;
-
-    // Create the payload for verification (same as Bun implementation)
-    const signingPayload = `${timestamp}.${body}`;
-
-    // Verify the signature using the same method as Bun
-    return crypto.verify(
-      null,
-      Buffer.from(signingPayload, "utf8"),
-      publicKey,
-      Buffer.from(signature, "base64")
-    );
-  } catch (error) {
-    console.error("Signature verification failed:", error);
-    return false;
-  }
-}
-
-async function processWebhookEvent(eventType: string, data: any) {
-  switch (eventType) {
-    case "user.created":
-      console.log("user.created", data);
-      break;
-    case "kyc.status.changed":
-      console.log("kyc.status.changed", data);
-      break;
-    case "card.transaction.created":
-      console.log("card.transaction.created", data);
-      break;
-    // Handle other event types
-    default:
-      console.log(`Unhandled event type: ${eventType}`);
-  }
-}
-```
-
-</CodeGroup>
diff --git a/webhooks/introduction.mdx b/webhooks/introduction.mdx
deleted file mode 100644
index 81a7007..0000000
--- a/webhooks/introduction.mdx
+++ /dev/null
@@ -1,23 +0,0 @@
----
-title: "Introduction"
-description: "Learn how to integrate with Gnosis Pay webhooks to receive real-time event notifications."
----
-
-Webhooks provide real-time notifications when events happen in the Gnosis Pay system. Rather than constantly polling our APIs for updates, you can configure webhook endpoints to receive instant notifications about user activities, KYC status changes, card transactions, and more.
-
-Our [Sign-In with Ethereum (SIWE) authentication system](/auth) requires customers to generate short-lived tokens (JWTs) that expire after 1 hour. This means your application may not always have a valid token to fetch updated data from our APIs.
-To avoid problems, we send complete entity data whenever possible in our webhook payloads.
-
-## Enable Webhooks
-
-To enable webhooks for your account:
-
-1. **Contact your Gnosis Pay partner manager** or reach out to our technical support team
-2. **Provide your webhook endpoint URL** (must be publicly accessible and use HTTPS)
-3. **Wait for confirmation** that your webhook has been configured
-
-<Info>
-  **Setup Time**: Webhook configuration typically takes 1-2 business days after
-  you provide the required information.
-</Info>
-