***

title: Webhooks
slug: features/webhooks
subtitle: Receive real-time event notifications at your server without polling.
-------------------------------------------------------------------------------

Transak uses webhooks to push real-time event notifications to your server. Instead of polling the API for updates, Transak sends event data directly to a URL you provide to ensure faster updates and fewer unnecessary API calls.

## Supported Webhook Types

<CardGroup cols={2}>
  <Card title="Order Webhooks" icon="fa-light fa-bell" iconPosition="left" href="/features/webhooks#order-webhooks">
    Real-time notifications for order lifecycle events. Available for both **Widget** and **Whitelabel API** integrations.
  </Card>

  <Card title="KYC Webhooks" icon="fa-light fa-id-card" iconPosition="left" href="/features/webhooks#kyc-webhooks">
    Real-time notifications for KYC lifecycle events. Available **only** for **Whitelabel API** integrations.
  </Card>
</CardGroup>

## Add or Update Webhook

<Steps>
  <Step title="Contact & Submit your webhook request">
    <Frame>
      <div>
        Webhook URLs can only be added or updated after `KYB approval` in the production environment.
      </div>
    </Frame>

    Follow the steps in the [Need help in Integration](/getting-started/help-and-support#need-help-in-integration) section. Provide the following details:

    <table>
      <thead>
        <tr>
          <th>
            Field
          </th>

          <th>
            Description
          </th>
        </tr>
      </thead>

      <tbody>
        <tr>
          <td>
            <strong>Order Webhook URL</strong>
          </td>

          <td>
            Your HTTPS endpoint for order events
          </td>
        </tr>

        <tr>
          <td>
            <strong>KYC Webhook URL</strong>
          </td>

          <td>
            Your HTTPS endpoint for KYC events
          </td>
        </tr>

        <tr>
          <td>
            <strong>Environment</strong>
          </td>

          <td>
            <code>STAGING</code>

             or 

            <code>PRODUCTION</code>
          </td>
        </tr>
      </tbody>
    </table>

    <Frame>
      <div>
        Both Order and KYC webhook URLs must use `HTTPS` and be `publicly accessible` before they can be registered.
      </div>
    </Frame>
  </Step>

  <Step title="Await confirmation">
    Our team will review your request and notify you once the webhook URL has been successfully added or updated.
  </Step>
</Steps>

## Order Webhooks

Notify the partner’s backend in real time when an order’s status changes. These events allow partners to track order creation, status updates, completion, and failures.

### Events

<Tabs>
  <Tab title="On Ramp / NFT Checkout">
    <Table align={["left","left","left","left","left"]}>
      <thead>
        <tr>
          <th>
            Screen
          </th>

          <th>
            Webhook Event Code
          </th>

          <th>
            Status
          </th>

          <th>
            Description
          </th>

          <th>
            Response JSON
          </th>
        </tr>
      </thead>

      <tbody>
        <tr>
          <td>
            <img src="https://assets.transak.com/doc/3aea0d45f33e9c9228c480eb567813edac67de89bcfa04bc7fa74b9cf4b0f56b-Screenshot_2025-11-18_at_6.08.41_PM_1.png" />
          </td>

          <td>
            <Badge intent="warning" minimal>ORDER_CREATED</Badge>
          </td>

          <td>
            `AWAITING_PAYMENT_FROM_USER`
          </td>

          <td>
            When the order is created, but the payment has not been received yet.
          </td>

          <td>
            `{ webhookData: { id: '37969614-...', ... }, eventID: 'ORDER_CREATED' }`
          </td>
        </tr>

        <tr>
          <td>
            <img src="https://assets.transak.com/doc/79f9631c9e0666e72c9ad3b80ac390797eddc96a1d8b982781213dd82bdf1289-Screenshot_2025-11-18_at_6.08.17_PM_1.png" />
          </td>

          <td>
            <Badge intent="info" minimal>ORDER_PAYMENT_VERIFYING</Badge>
          </td>

          <td>
            `PAYMENT_DONE_MARKED_BY_USER`
          </td>

          <td>
            When the user marks the payment as done but it is not received by us yet.
          </td>

          <td />
        </tr>

        <tr>
          <td>
            <img src="https://assets.transak.com/doc/59caa8e5d46d2607884fa11fd6c1fc28e94ef1aca1e78895353e964bc9782196-Screenshot_2025-11-18_at_4.58.37_PM.png" />
          </td>

          <td>
            <Badge intent="info" minimal>ORDER_PROCESSING</Badge>
          </td>

          <td>
            `PROCESSING`
          </td>

          <td>
            Orders in the PROCESSING state have passed the checks and the user's payment information has been validated.
          </td>

          <td>
            `{ webhookData: { id: 'e0d9f47a-...', ... }, eventID: 'ORDER_PROCESSING' }`
          </td>
        </tr>

        <tr>
          <td>
            <img src="https://assets.transak.com/doc/4240afa02eb260e1221b03fffd0f2ad5d427c35958c06e3eb570e3d5d8619295-Screenshot_2025-11-18_at_4.58.57_PM.png" />
          </td>

          <td>
            <Badge intent="info" minimal>ORDER_PROCESSING</Badge>
          </td>

          <td>
            `PENDING_DELIVERY_FROM_TRANSAK`
          </td>

          <td>
            When the payment is received and is being exchanged & transferred via us or our liquidity partner.
          </td>

          <td>
            `{ webhookData: { id: 'e0d9f47a-...', ... }, eventID: 'ORDER_PROCESSING' }`
          </td>
        </tr>

        <tr>
          <td>
            <img src="https://assets.transak.com/doc/58da5f11266616dbe3b82fa8b29418ea7383166afd14f8bff1cae195c6bb9e3f-Screenshot_2025-11-18_at_4.59.20_PM.png" />
          </td>

          <td>
            <Badge intent="success" minimal>ORDER_COMPLETED</Badge>
          </td>

          <td>
            `COMPLETED`
          </td>

          <td>
            When we have received the payment and the crypto is sent successfully to the user.
          </td>

          <td>
            `{ webhookData: { id: 'e0d9f47a-...', ... }, eventID: 'ORDER_COMPLETED' }`
          </td>
        </tr>

        <tr>
          <td>
            <img src="https://assets.transak.com/doc/199185170fdfa9cac9d97affe95f91f980b100488d8114875085f88de373d89e-Screenshot_2025-11-18_at_5.50.22_PM.png" />
          </td>

          <td>
            <Badge intent="error" minimal>ORDER_FAILED</Badge>
          </td>

          <td>
            `CANCELLED`
          </td>

          <td>
            When the user cancels the order.
          </td>

          <td>
            `{ webhookData: { id: '08c570cf-...', ... }, eventID: 'ORDER_FAILED' }`
          </td>
        </tr>

        <tr>
          <td>
            <img src="https://assets.transak.com/doc/48d5eeb2e244fa3765b688fc37650eb72633f1db8786acee0f419c3b042b8189-CleanShot_2025-11-18_at_19.21.132x.png" />
          </td>

          <td>
            <Badge intent="error" minimal>ORDER_FAILED</Badge>
          </td>

          <td>
            `FAILED`
          </td>

          <td>
            When the order failed because of a card decline.
          </td>

          <td>
            `{ webhookData: { id: '08c570cf-...', ... }, eventID: 'ORDER_FAILED' }`
          </td>
        </tr>

        <tr>
          <td>
            <img src="https://assets.transak.com/doc/496e4c7d60f6299d67090f8c6aaaaeaabfb5d23e5e2608d8cd4cccd8d9e2b432-CleanShot_2025-11-18_at_19.25.212x.png" />
          </td>

          <td>
            <Badge intent="neutral" minimal>ORDER_REFUNDED</Badge>
          </td>

          <td>
            `REFUNDED`
          </td>

          <td>
            When fiat payment received from the user is refunded back to their payment instrument as cryptocurrency could not be fulfilled due to some reason.
          </td>

          <td>
            `{ webhookData: { id: '08c570cf-...', ... }, eventID: 'ORDER_REFUNDED' }`
          </td>
        </tr>

        <tr>
          <td>
            <img src="https://assets.transak.com/doc/ddac542b17dc3d09b9869a39bf29d2231b02e158261e70ea78f67ad049c971b9-CleanShot_2025-11-18_at_19.24.262x.png" />
          </td>

          <td>
            <Badge intent="error" minimal>ORDER_FAILED</Badge>
          </td>

          <td>
            `EXPIRED`
          </td>

          <td>
            When the user failed to make the payment within the timeframe.
          </td>

          <td>
            `{ webhookData: { id: '08c570cf-...', ... }, eventID: 'ORDER_EXPIRED' }`
          </td>
        </tr>
      </tbody>
    </Table>
  </Tab>

  <Tab title="Off Ramp">
    <Table align={["left","left","left","left"]}>
      <thead>
        <tr>
          <th>
            Screen
          </th>

          <th>
            Webhook Event Code
          </th>

          <th>
            Status
          </th>

          <th>
            Description
          </th>
        </tr>
      </thead>

      <tbody>
        <tr>
          <td>
            <img src="https://assets.transak.com/doc/49d1cc00f25466da9d76c841100158c6095316af9cc0d64c916474836fd005bd-Screenshot_2025-11-19_at_7.02.42_PM.png" />
          </td>

          <td>
            <Badge intent="warning" minimal>ORDER_CREATED</Badge>
          </td>

          <td>
            `AWAITING_PAYMENT_FROM_USER`
          </td>

          <td>
            When the order is created but the payment has not been received yet.
          </td>
        </tr>

        <tr>
          <td>
            <img src="https://assets.transak.com/doc/3743fcffc2d3548196f0df1214699fadac3d4d35ba4b240d2aaaa12a1b35d0f7-Screenshot_2025-11-19_at_7.03.45_PM.png" />
          </td>

          <td>
            <Badge intent="info" minimal>ORDER_PAYMENT_VERIFYING</Badge>
          </td>

          <td>
            `PAYMENT_DONE_MARKED_BY_USER`
          </td>

          <td>
            When the user marks the payment as done but it is not received by us yet.
          </td>
        </tr>

        <tr>
          <td>
            <img src="https://assets.transak.com/doc/aed23eba4e8f0f695ed437b9f282f1433339126c890308e093d61bf93fc53363-Screenshot_2025-11-19_at_7.04.01_PM.png" />
          </td>

          <td>
            <Badge intent="info" minimal>ORDER_PROCESSING</Badge>
          </td>

          <td>
            `PENDING_DELIVERY_FROM_TRANSAK`
          </td>

          <td>
            When the payment is received and reconciled and we have initiated a fiat transfer to the user.
          </td>
        </tr>

        <tr>
          <td>
            <img src="https://assets.transak.com/doc/199185170fdfa9cac9d97affe95f91f980b100488d8114875085f88de373d89e-Screenshot_2025-11-18_at_5.50.22_PM.png" />
          </td>

          <td>
            <Badge intent="info" minimal>ORDER_PROCESSING</Badge>
          </td>

          <td>
            `ON_HOLD_PENDING_DELIVERY_FROM_TRANSAK`
          </td>

          <td>
            When the crypto payment is received & fiat is being transferred via our banking partner but our system is unable to send the fiat to the user.
          </td>
        </tr>

        <tr>
          <td>
            <img src="https://assets.transak.com/doc/8d8fb8f13c396002847d4a0cfe7dd8568dccb6244f3a9126ff8b12cecd021fd9-Screenshot_2025-11-19_at_7.05.44_PM.png" />
          </td>

          <td>
            <Badge intent="success" minimal>ORDER_COMPLETED</Badge>
          </td>

          <td>
            `COMPLETED`
          </td>

          <td>
            When the fiat has been sent successfully to the user.
          </td>
        </tr>

        <tr>
          <td>
            <img src="https://assets.transak.com/doc/679da481ebea88688a84158ecc41c5854b90ee7b8d0305b31b2a75c6e8878403-CleanShot_2025-11-18_at_19.21.132x.png" />
          </td>

          <td>
            <Badge intent="error" minimal>ORDER_FAILED</Badge>
          </td>

          <td>
            `EXPIRED`
          </td>

          <td>
            When the user failed to make the payment within the timeframe.
          </td>
        </tr>

        <tr>
          <td>
            <img src="https://assets.transak.com/doc/3aea0d45f33e9c9228c480eb567813edac67de89bcfa04bc7fa74b9cf4b0f56b-Screenshot_2025-11-18_at_6.08.41_PM_1.png" />
          </td>

          <td>
            <Badge intent="error" minimal>ORDER_FAILED</Badge>
          </td>

          <td>
            `FAILED`
          </td>

          <td>
            Due to third-party failure.
          </td>
        </tr>

        <tr>
          <td>
            <img src="https://assets.transak.com/doc/de11fe9577e246a31cb8b9b4bb2aed7c8cfe762461871d28dd620c7402ac5a64-Screenshot_2025-11-20_at_12.10.52_PM.png" />
          </td>

          <td>
            <Badge intent="error" minimal>ORDER_FAILED</Badge>
          </td>

          <td>
            `CANCELLED`
          </td>

          <td>
            When the user manually cancels the order.
          </td>
        </tr>

        <tr>
          <td>
            <img src="https://assets.transak.com/doc/552f975b6fdf39334c74b3f1d81829ddeb4842efdf5df4512b695cde1c682b1d-CleanShot_2025-11-18_at_19.25.212x.png" />
          </td>

          <td>
            <Badge intent="neutral" minimal>ORDER_REFUNDED</Badge>
          </td>

          <td>
            `REFUNDED`
          </td>

          <td>
            When cryptocurrency payment received from the user is refunded back to their wallet as fiat payout could not be fulfilled due to some reason.
          </td>
        </tr>
      </tbody>
    </Table>
  </Tab>
</Tabs>

### Decrypting the Webhook Payload

The webhook `data` field is a JWT encrypted using your Access Token. Use the code samples below to verify and decode it. You can generate an Access Token using this [guide](/guides/how-to-create-partner-access-token).

<Tabs>
  <Tab title="JavaScript">
    <Steps>
      <Step title="Install the dependency">
        **NPM Package:** [`jsonwebtoken`](https://www.npmjs.com/package/jsonwebtoken)

        ```bash
        npm install jsonwebtoken
        ```
      </Step>

      <Step title="Verify and decode the webhook payload">
        ```javascript
        import jwt from "jsonwebtoken";

        // JWT token received from the webhook response's data field
        const webhookData = "eyJhbGciOiJIU.eyJ3ZWJob29-rRGF0.W07q-JG6jlyzid4";

        // Your Access Token — used as the signing secret
        const accessToken = "ACCESS_TOKEN";

        // Verify and decode the JWT token
        const decodedData = jwt.verify(webhookData, accessToken);

        console.log(decodedData);
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="Java">
    <Tabs>
      <Tab title="Gradle">
        <Steps>
          <Step title="Install Dependencies">
            ```groovy
            dependencies {
                implementation 'io.jsonwebtoken:jjwt-api:0.11.5'
                implementation 'io.jsonwebtoken:jjwt-impl:0.11.5'
                implementation 'io.jsonwebtoken:jjwt-jackson:0.11.5'
            }
            ```
          </Step>

          <Step title="Verify and decode the webhook payload">
            ```java
            package com.transak.webhookjavamaven;

            import io.jsonwebtoken.Claims;
            import io.jsonwebtoken.Jwts;
            import io.jsonwebtoken.security.Keys;
            import javax.crypto.SecretKey;

            public class WebhookJavaMavenApplication {

                public static void main(String[] args) {
                    // JWT token received from the webhook response's data field
                    String webhookData = "eyJhbGciOiJIU.eyJ3ZWJob29-rRGF0.W07q-JG6jlyzid4";

                    // Your Access Token — used as the signing secret
                    String accessToken = "ACCESS_TOKEN";

                    SecretKey key = Keys.hmacShaKeyFor(accessToken.getBytes());

                    Claims claims = Jwts.parserBuilder()
                            .setSigningKey(key)
                            .build()
                            .parseClaimsJws(webhookData)
                            .getBody();

                    System.out.println("Claims: " + claims);
                }
            }
            ```
          </Step>
        </Steps>
      </Tab>

      <Tab title="Maven">
        <Steps>
          <Step title="Install Dependencies">
            ```xml
            <dependencies>
                <dependency>
                    <groupId>io.jsonwebtoken</groupId>
                    <artifactId>jjwt-api</artifactId>
                    <version>0.11.5</version>
                </dependency>
                <dependency>
                    <groupId>io.jsonwebtoken</groupId>
                    <artifactId>jjwt-impl</artifactId>
                    <version>0.11.5</version>
                </dependency>
                <dependency>
                    <groupId>io.jsonwebtoken</groupId>
                    <artifactId>jjwt-jackson</artifactId>
                    <version>0.11.5</version>
                </dependency>
            </dependencies>
            ```
          </Step>

          <Step title="Verify and decode the webhook payload">
            ```java
            package com.transak.webhookjavamaven;

            import io.jsonwebtoken.Claims;
            import io.jsonwebtoken.Jwts;
            import io.jsonwebtoken.security.Keys;
            import javax.crypto.SecretKey;

            public class WebhookJavaMavenApplication {

                public static void main(String[] args) {
                    // JWT token received from the webhook response's data field
                    String webhookData = "eyJhbGciOiJIU.eyJ3ZWJob29-rRGF0.W07q-JG6jlyzid4";

                    // Your Access Token — used as the signing secret
                    String accessToken = "ACCESS_TOKEN";

                    SecretKey key = Keys.hmacShaKeyFor(accessToken.getBytes());

                    Claims claims = Jwts.parserBuilder()
                            .setSigningKey(key)
                            .build()
                            .parseClaimsJws(webhookData)
                            .getBody();

                    System.out.println("Claims: " + claims);
                }
            }
            ```
          </Step>
        </Steps>
      </Tab>
    </Tabs>
  </Tab>

  <Tab title="Go">
    <Steps>
      <Step title="Install Dependencies">
        **Package:** [`github.com/golang-jwt/jwt/v5`](https://pkg.go.dev/github.com/golang-jwt/jwt/v5)

        ```bash
        go get github.com/golang-jwt/jwt/v5
        ```
      </Step>

      <Step title="Verify and decode the webhook payload">
        ```go
        package main

        import (
          "encoding/json"
          "fmt"
          "log"

          "github.com/golang-jwt/jwt/v5"
        )

        func main() {
          // JWT token received from the webhook response's data field
          webhookData := "eyJhbGciOiJIU.eyJ3ZWJob29-rRGF0.W07q-JG6jlyzid4"

          // Your Access Token — used as the signing secret
          secretKey := "ACCESS_TOKEN"

          token, _ := jwt.Parse(webhookData, func(token *jwt.Token) (interface{}, error) {
            return []byte(secretKey), nil
          })

          if claims, ok := token.Claims.(jwt.MapClaims); ok && token.Valid {
            jsonData, _ := json.MarshalIndent(claims, "", "  ")
            fmt.Println("Decoded JWT Claims:\n", string(jsonData))
          } else {
            log.Println("Invalid JWT or claims")
          }
        }
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

#### Sample Decrypted Payload

<CodeBlock language="json">
  ```json
  {
    "webhookData": {
      "id": "181b6159-2192-4f68-8647-f48e6e8f58c7",
      "walletAddress": "0xD902d7eBF7bcE",
      "createdAt": "2024-08-23T10:33:09.426Z",
      "status": "COMPLETED",
      "fiatCurrency": "EUR",
      "userId": "243a8ce2-9cc6-41a9-aaeb-b0deeb09a3",
      "cryptoCurrency": "ETH",
      "isBuyOrSell": "BUY",
      "fiatAmount": 32,
      "ipAddress": "35.177.158.9",
      "amountPaid": 32,
      "paymentOptionId": "sepa_bank_transfer",
      "walletLink": "https://sepolia.etherscan.io/address/0xD902d7eBF7bcE",
      "quoteId": "0b9edf4d-2de1-4f2e-bdb6-07bc61c380f5",
      "orderProcessingType": "NORMAL",
      "addressAdditionalData": false,
      "network": "ethereum",
      "conversionPrice": 0.00041416655266757863,
      "cryptoAmount": 0.01211023,
      "totalFeeInFiat": 2.76,
      "fiatAmountInUsd": 35.57,
      "countryCode": "IN",
      "stateCode": "Karnataka",
      "orderChannelType": "WIDGET",
      "userKycType": "STANDARD",
      "cardPaymentData": {
        "orderId": "181b6159-2192-4f68-8647-f48e6e8f58c7",
        "paymentId": "66c8656bb38a7908fadc77db",
        "pgData": {
          "paymentOptions": [
            {
              "currency": "EUR",
              "id": "sepa_bank_transfer",
              "name": "Bank Transfer Details",
              "fields": [
                { "name": "Bank Name", "value": "Transak Limited" },
                { "name": "IBAN", "value": "GB69MOCK00000003743944" },
                { "name": "Bank Name", "value": "Modulr" },
                { "name": "Bank Address", "value": "Scale Space, 58 Wood Lane, London, W12 7RZ" }
              ]
            }
          ],
          "liquidityProvider": "MODULR",
          "status": "CREATED"
        },
        "liquidityProvider": "MODULR",
        "updatedAt": "2024-08-23T10:33:58.753Z",
        "status": "CAPTURED",
        "processedOn": "2024-08-23T10:33:57.000Z"
      },
      "statusHistories": [
        {
          "status": "PENDING_DELIVERY_FROM_TRANSAK",
          "createdAt": "2024-08-23T10:33:59.408Z",
          "message": "💸 Payment reconciled successfully. Received 32 EUR",
          "isEmailSentToUser": false,
          "partnerEventId": "ORDER_PROCESSING"
        }
      ],
      "isFirstOrder": false,
      "updatedAt": "2024-08-23T10:34:06.371Z",
      "completedAt": "2024-08-23T10:34:39.412Z",
      "transactionHash": "DUMMY_TX_ID",
      "transactionLink": "https://sepolia.etherscan.io/tx/DUMMY_TX_ID",
      "conversionPriceData": {
        "id": "139474c7-99c5-4232-9a05-c6ccd6a973ed",
        "createdAt": "2024-08-23T10:34:06.352Z",
        "fiatCurrency": "EUR",
        "cryptoCurrency": "ETH",
        "paymentMethod": "sepa_bank_transfer",
        "fiatAmount": 32,
        "network": "ethereum",
        "cryptoAmount": 0.01211023,
        "isBuyOrSell": "BUY",
        "conversionPrice": 0.00041416641727771563,
        "marketConversionPrice": 0.00041628949369556297,
        "slippage": 0.51,
        "cryptoLiquidityProvider": "transak",
        "fiatLiquidityProvider": "coinbase",
        "partnerApiKey": "d79671a4-b021-4a4f-a444-6862a680a94b",
        "sourceTokenAmount": 0.012110226041200406,
        "sourceToken": "ETH",
        "notes": [],
        "fiatFeeAmount": 2.76,
        "feeDecimal": 0.08625,
        "swaps": [
          {
            "sourceCurrency": "EUR",
            "destinationCurrency": "USDT",
            "sourceAmount": 32,
            "destinationAmount": 35.57563545494966,
            "paymentMethod": "sepa_bank_transfer",
            "liquidityProvider": "coinbase",
            "conversionPrice": 1.111738607967177,
            "feeInSourceAmount": 0,
            "networkFeeInSourceAmount": 0,
            "marketConversionPrice": 1.111738607967177,
            "isNonCustodial": false,
            "isFiatliquidityProvider": true,
            "isFiatPartnerDirectCryptoDeposit": false,
            "isFiatPartnerAccountWalletDeposit": false,
            "liquidityProviderData": false,
            "originalDestinationAmount": 35.57563545494966
          },
          {
            "sourceCurrency": "USDT",
            "destinationCurrency": "ETH",
            "sourceAmount": 35.57563545494966,
            "destinationAmount": 0.0132533253528869,
            "liquidityProvider": "transak",
            "conversionPrice": 0.0003725393849863884,
            "networkFeeInSourceAmount": 0,
            "networkFeeInDestinationAmount": 0,
            "marketConversionPrice": 0.0003725393849863884,
            "liquidityProviderData": false,
            "isNonCustodial": false
          },
          {
            "sourceCurrency": "ETH",
            "destinationCurrency": "ETH",
            "sourceAmount": 0.0132533253528869,
            "destinationAmount": 0.0132533253528869,
            "liquidityProvider": "transak",
            "conversionPrice": 1,
            "isCryptoliquidityProvider": true,
            "networkFeeInSourceAmount": 0.000067651170404,
            "networkFeeInDestinationAmount": 0.000067651170404,
            "marketConversionPrice": 1,
            "liquidityProviderData": false,
            "isFiatPartnerAccountWalletDeposit": false
          }
        ],
        "fees": [
          {
            "name": "Transak fee",
            "value": 2.6,
            "id": "transak_fee",
            "ids": ["transak_fee", "partner_fee"]
          },
          {
            "name": "Network/Exchange fee",
            "value": 0.16,
            "id": "network_fee",
            "ids": ["network_fee"]
          }
        ],
        "fiatAmountInUsd": 35.57,
        "internalFees": [
          { "name": "Network/Exchange fee", "id": "network_fee", "value": 0.16 },
          { "name": "Transak fee", "id": "transak_fee", "value": 1 },
          { "name": "Transak fee", "id": "partner_fee", "value": 1.6 }
        ],
        "cost": {
          "ethPriceInLocalCurrency": 2402.17448469,
          "gasCostinLocalCurrency": 0.16334786495892,
          "transakMinimumFee": 1,
          "transakFeeAmount": 1,
          "fiatLiquidityProviderFee": 0,
          "gasCostinLocalCurrencyByFiatPartner": 0,
          "gasCostinLocalCurrencyByCryptoPartner": 0,
          "partnerFeeDecimal": 0.05,
          "partnerFeeInLocalCurrency": 1.6,
          "totalFeeDecimal": 0.08625,
          "totalFeeAmount": 2.76,
          "gasCurrency": "ETH",
          "gasInNativeToken": 0.000068,
          "gasCurrencyRateInUsd": 0.0003744603090795391,
          "totalAmountChargedByTransak": 2.76334786495892
        }
      },
      "partnerFeeInLocalCurrency": 1.6
    },
    "eventID": "ORDER_COMPLETED",
    "createdAt": "2024-08-23T10:34:40.070Z"
  }
  ```
</CodeBlock>

## KYC Webhooks

Notify partner's backend in real-time when a user's KYC verification status changes. These events allow to track KYC submissions, approvals and rejections.

### Events

The following Event IDs are triggered during the KYC lifecycle and sent via webhook

<table>
  <thead>
    <tr>
      <th>
        Event ID
      </th>

      <th>
        KYC Status
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <code>
          KYC_SUBMITTED
        </code>
      </td>

      <td>
        SUBMITTED
      </td>

      <td>
        Triggered when a user submits their KYC details
      </td>
    </tr>

    <tr>
      <td>
        <code>
          KYC_APPROVED
        </code>
      </td>

      <td>
        APPROVED
      </td>

      <td>
        Triggered when the user's KYC verification is approved
      </td>
    </tr>

    <tr>
      <td>
        <code>
          KYC_REJECTED
        </code>
      </td>

      <td>
        REJECTED
      </td>

      <td>
        Triggered when the user's KYC verification is rejected
      </td>
    </tr>
  </tbody>
</table>

### Webhook Response

#### Schema

<Tabs>
  <Tab title="Mandatory">
    <ParamField path="kycStatus" type="string" required={true}>
      The KYC verification status (SUBMITTED, APPROVED, or REJECTED)
    </ParamField>

    <ParamField path="eventID" type="string" required={true}>
      The event identifier (KYC\_SUBMITTED, KYC\_APPROVED, or KYC\_REJECTED)
    </ParamField>

    <ParamField path="partnerUserId" type="string" required={true}>
      The unique identifier for the user in the partner's system
    </ParamField>
  </Tab>

  <Tab title="Optional">
    <ParamField path="partnerCustomerId" type="string">
      Custom identifier for the customer. Returned only if provided in the [Quote API](/api/whitelabel/lookup/get-quote) request.
    </ParamField>
  </Tab>
</Tabs>

```json Response Schema
{
  "data": {
    "kycStatus": "string",
    "eventID": "string",
    "partnerUserId": "string",
    "partnerCustomerId": "string" //Optional
  }
}
```

#### Sample Response

<AccordionGroup>
  <Accordion title="KYC_SUBMITTED" defaultOpen={true}>
    <Tabs>
      <Tab title="With partnerCustomerId">
        ```json
        {
          "data": {
            "kycStatus": "SUBMITTED",
            "eventID": "KYC_SUBMITTED",
            "partnerUserId": "0870c29f-75a8-4091-a068-775fa4577172",
            "partnerCustomerId": "12345"
          }
        }
        ```
      </Tab>

      <Tab title="Without partnerCustomerId">
        ```json
        {
          "data": {
            "kycStatus": "SUBMITTED",
            "eventID": "KYC_SUBMITTED",
            "partnerUserId": "0870c29f-75a8-4091-a068-775fa4577172"
          }
        }
        ```
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="KYC_APPROVED">
    <Tabs>
      <Tab title="With partnerCustomerId">
        ```json
        {
          "data": {
            "kycStatus": "APPROVED",
            "eventID": "KYC_APPROVED",
            "partnerUserId": "0870c29f-75a8-4091-a068-775fa4577172",
            "partnerCustomerId": "12345"
          }
        }
        ```
      </Tab>

      <Tab title="Without partnerCustomerId">
        ```json
        {
          "data": {
            "kycStatus": "APPROVED",
            "eventID": "KYC_APPROVED",
            "partnerUserId": "0870c29f-75a8-4091-a068-775fa4577172"
          }
        }
        ```
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="KYC_REJECTED">
    <Tabs>
      <Tab title="With partnerCustomerId">
        ```json
        {
          "data": {
            "kycStatus": "REJECTED",
            "eventID": "KYC_REJECTED",
            "partnerUserId": "0870c29f-75a8-4091-a068-775fa4577172",
            "partnerCustomerId": "12345"
          }
        }
        ```
      </Tab>

      <Tab title="Without partnerCustomerId">
        ```json
        {
          "data": {
            "kycStatus": "REJECTED",
            "eventID": "KYC_REJECTED",
            "partnerUserId": "0870c29f-75a8-4091-a068-775fa4577172"
          }
        }
        ```
      </Tab>
    </Tabs>
  </Accordion>
</AccordionGroup>