Wert

https://docs.wert.io/docs
Admin
Wert offers fiat onramp and NFT checkout solutions, enabling simple crypto purchases with a card and...
Tokens:32,599
Snippets:85
Trust Score:9.2
Update:1 year ago
Show doc for...
Tokens:
Raw
### JSON Webhook Examples for Wert.io Events

Source: https://docs.wert.io/docs/webhooks

Demonstrates the JSON structure for different Wert.io webhook events. This includes examples for 'verify_failed', 'order_failed', and 'order_complete' events, highlighting the inclusion of user and order details, and specific fields for smart contract interactions.

```json
{
  "type": "verify_failed",
  "click_id": "6380534230062343906",
  "user": {
     "user_id": "01HWBC52H04XN6ETYMABXXXXX",
      "verification_status": {
         "lkyc": { "state": "success" },
         "fkyc": { "state": "success" },
      }
   }
   ....
}
```

```json
{
  "type": "order_failed",
  "click_id": "6380534230062343906",
  "user": {
    "user_id": "01HWBC52H04XN6ETYMABXXXXX",
    "verification_status": {
      "lkyc": { "state": "success" },
      "fkyc": { "state": "success" }
    }
  },
  "order": {
    "id": "01HWBC52H04XN6ETYMAXXXXX",
    "base": "ETH",
    "base_amount": "0.0159251",
    "quote": "USD",
    "quote_amount": "53.63",
    "address": "0xF63EBd44b355b32F7E0ef65B87A0DB2fa95D8E62",
    "transaction_id": "0x8cdc3eca9b2e878cc97f326df3d420fc6809d24a38899b40e6dd5c4cbcf7b561"
  }
}
```

```json
{
  "type": "order_complete",
  "click_id": "6380534230062343906",
  "user": {
    "user_id": "01HWBC52H04XN6ETYMABXXXXX",
    "verification_status": {
      "lkyc": { "state": "success" },
      "fkyc": { "state": "success" }
    }
  },
  "order": {
    "id": "01HYGMBG18D8P5CK7RN1K8MY2E",
    "base": "MATICSC",
    "base_amount": "3.67",
    "quote": "USD",
    "quote_amount": "2.85",
    "address": "0xF63EBd44b355b32F7E0ef65B87A0DB2fa95D8E62",
    "transaction_id": "0x3b3bafbc97abbbb2ed6f5b5825bcfc409e4cc05658e8530cf5750f2d35952edf",
    "partner_data": {
      "sc_id": "",
      "sc_address": "0xfc5eecb69d262b184ac1347018d381d66d3c4",
      "sc_input_data": "0x3c168eab000000000000000000000000e696823a3231b87eec57b8925d64e340c12044a60000000000000000000000000000000000000000000000000000000000000001"
    }
  }
}
```

--------------------------------

### Wert Widget Smart Contract Data Generation Example

Source: https://docs.wert.io/docs/generate-signed-data

A detailed JavaScript example for generating signed data for smart contract execution using the Wert widget. This includes necessary imports for `signSmartContractData`, `uuidv4`, and `Buffer`. It also shows how to initialize the Wert widget with the generated signed data and partner ID. Note the browser-specific `window.Buffer = Buffer;` assignment.

```javascript
import { signSmartContractData } from '@wert-io/widget-sc-signer';
import { v4 as uuidv4 } from 'uuid';
import { Buffer } from 'buffer/';

window.Buffer = Buffer; // needed to use `signSmartContractData` in browser

const signedData = signSmartContractData(
  {
    address: '0x96D5990185022212d367A0e09263B12Dbb4EE06A',
    commodity: 'ETH',
    network: 'ethereum',
    commodity_amount: 0.005,
    sc_address: '0x3b2305502bd6f8b1eb2ed474ac15c61c6702b18b',
    sc_input_data:
      '0x9dae76ea000000000000000000000000000000000000000000000000000000000000003700000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001',
  },
  privateKey
);

const wertWidget = new WertWidget({
	partner_id: 'YOUR_PARTNER_ID',
  ...signedData,
});
```

--------------------------------

### Initialize Wert Widget using SDK

Source: https://docs.wert.io/docs/nft-checkout

This snippet demonstrates how to import and initialize the Wert Widget using the official SDK. It assumes the SDK has been installed. The configuration options are placeholders and would need to be filled with specific project details.

```javascript
import WertWidget from "@wert-io/widget-initializer";

// Initialize the payment module
const wertWidget = new WertWidget({
  // Configuration options
  // ...
});

// Further code to handle widget events and interactions
```

--------------------------------

### Example: Setting Currencies in Wert.io Widget

Source: https://docs.wert.io/docs/nft-checkout

Demonstrates how to specify a list of currencies to be displayed in the Wert.io widget. If the list is empty or invalid, all supported currencies are shown. Mismatched currencies in certain sessions can lead to a purchase restriction.

```javascript
JSON.stringify(['EUR'])

```

--------------------------------

### Get User Data from Wert API (Shell)

Source: https://docs.wert.io/docs/data-api

This example shows how to retrieve detailed user data from the Wert.io API using a GET request. It requires a user ID and an API key. The response contains various user attributes, KYC statuses, and payment method details.

```shell
curl -X GET 'https://partner.wert.io/api/external/users?user_ids=01JP7C3WV0BXEWP5ZF2Q8MQ7P0' \
  -H 'X-Api-Key: your-unique-api-key' \
  -H 'Content-Type: application/json'
```

--------------------------------

### Configure Wert.io Widget with Selected Commodities and Addresses (JavaScript)

Source: https://docs.wert.io/docs/extra-object-fiat-onramp

This example illustrates how to configure the Wert.io widget to display only specific cryptocurrencies and provide pre-filled addresses for them. This is useful for guiding users to specific payment options while ensuring their addresses are already populated.

```javascript
const wertWidget = new WertWidget({
  // ... other properties
  commodities: JSON.stringify([
    {
      commodity: "ETH",
      network: "ethereum",
    },
    {
      commodity: "XTZ",
      network: "tezos",
    },
    {
      commodity: 'MATIC',
      network: 'polygon',
    },
  ]),
  extra: {
    wallets: [
      {
        name: "ETH", // case-ignored
        network: "ethereum", // case-ignored
        address: "0x0E976df9bb3ac63F7802ca843C9d121aE2Ef22ee",
      },
      {
        name: "XTZ", // case-ignored
        network: "tezos", // case-ignored
        address: "tz1LjQKVfHCCCYm8DDYKPzL5w4nCtobiZmSr",
      },
      {
        name: "MATIC", // case-ignored
        network: "polygon", // case-ignored
        address: "0x0E976df9bb3ac63F7802ca843C9d121aE2Ef22ee",
      },
    ],
  },
});
```

--------------------------------

### Create User with Wert and Initiate LKYC (Shell)

Source: https://docs.wert.io/docs/data-api

This example demonstrates how to create a user via the Wert.io API and automatically initiate the LKYC (Local KYC) process. It requires an API key and sends user details in JSON format to the specified endpoint. The response includes a user ID and creation timestamp.

```shell
curl -X POST 'https://partner.wert.io/api/external/users/create' \
  -H 'X-Api-Key: your-unique-api-key' \
  -H 'Content-Type: application/json' \
  -d '{
    "has_accepted_terms_of_service": true,
    "phone": "+1234567890",
    "email": "john.doe@example.com",
    "first_name": "John",
    "middle_name": "Paul",
    "last_name": "Doe",
    "date_of_birth": "1990-01-01",
    "country_of_residence": "USA",
    "state_of_residence": "CA"
  }'
```

--------------------------------

### GET /api/external/users

Source: https://context7.com/context7/wert_io/llms.txt

Retrieves user information including KYC status and payment limits.

```APIDOC
## GET /api/external/users

### Description
Retrieves user information including KYC status and payment limits.

### Method
GET

### Endpoint
https://partner.wert.io/api/external/users

### Parameters
#### Path Parameters
None

#### Query Parameters
- **user_ids** (string) - Required - A comma-separated list of user IDs to retrieve.

#### Request Body
None

### Request Example
```bash
curl -X GET 'https://partner.wert.io/api/external/users?user_ids=01JP7C3WV0BXEWP5ZF2Q8MQ7P0' \
-H 'X-Api-Key: your_api_key_here' \
-H 'Content-Type: application/json'
```

### Response
#### Success Response (200 OK)
- **data** (array) - An array of user objects.
  - **user_id** (string) - The unique identifier for the user.
  - **created_at** (string) - The timestamp when the user was created.
  - **country** (string) - The user's country.
  - **state** (string) - The user's state.
  - **phone** (string) - The user's phone number (partially masked).
  - **phone_country** (string) - The country code for the user's phone number.
  - **lkyc_status** (string) - The status of the light KYC check.
  - **fkyc_status** (string) - The status of the full KYC check.
  - **limits** (object) - User's spending limits.
    - **crypto_spending** (number) - Total allowed crypto spending.
    - **crypto_remaining** (number) - Remaining crypto spending allowance.
    - **digital_goods_spending** (number) - Total allowed digital goods spending.
    - **digital_goods_remaining** (number) - Remaining digital goods spending allowance.
  - **linked_payment_methods** (array) - Details of linked payment methods.
    - **method** (string) - The type of payment method.
    - **cards** (array) - List of linked cards.
      - **card_id** (string) - The unique identifier for the card.
      - **brand** (string) - The brand of the card (e.g., Visa).
      - **last_digits** (string) - The last four digits of the card number.
      - **created_at** (string) - The timestamp when the card was linked.
- **success** (boolean) - Indicates if the request was successful.
- **total** (integer) - The total number of users returned.

#### Response Example
```json
{
  "data": [
    {
      "user_id": "01HPPKVTKC3VKXC95ADA8M5JTA",
      "created_at": "2019-05-15T12:30:45Z",
      "country": "US",
      "state": "CA",
      "phone": "+1*****345",
      "phone_country": "US",
      "lkyc_status": "success",
      "fkyc_status": "not initiated",
      "limits": {
        "crypto_spending": 1000.07,
        "crypto_remaining": 500.03,
        "digital_goods_spending": 0,
        "digital_goods_remaining": 1500
      },
      "linked_payment_methods": [
        {
          "method": "bank_card",
          "cards": [
            {
              "card_id": "01HPPKVTHGGHHDA8M5JTA",
              "brand": "Visa",
              "last_digits": "4242",
              "created_at": "2024-05-01T10:30:00Z"
            }
          ]
        }
      ]
    }
  ],
  "success": true,
  "total": 1
}
```
```

--------------------------------

### Create Payment Session - Simple Flow (cURL)

Source: https://docs.wert.io/docs/fiat-onramp

This example demonstrates how to create a simple payment session using the Wert.io API via cURL. It requires a flow_type and an API key. The response includes a sessionId and requestId.

```cURL
curl -X POST "https://partner-sandbox.wert.io/api/external/hpp/create-session" \
-H "X-Api-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"flow_type": "simple" // flow_type is always required
}'
```

--------------------------------

### Get User Data - User Details API (Bash)

Source: https://context7.com/context7/wert_io/llms.txt

Retrieves user information, including KYC status and payment limits, using the User Details API. It requires the user ID and an API key. The response includes details about the user's limits and linked payment methods.

```bash
curl -X GET 'https://partner.wert.io/api/external/users?user_ids=01JP7C3WV0BXEWP5ZF2Q8MQ7P0' \
-H 'X-Api-Key: your_api_key_here' \
-H 'Content-Type: application/json'
```

--------------------------------

### Configure Wert.io Widget with Single Wallet Address (JavaScript)

Source: https://docs.wert.io/docs/extra-object-fiat-onramp

This example demonstrates how to initialize the Wert.io widget with a single cryptocurrency asset and a pre-filled user address. It's useful when you know the specific asset and the user's wallet for that asset.

```javascript
const wertWidget = new WertWidget({
  // ... other properties
  commodity: "XTZ",
  network: "tezos",
  address: "tz1LjQKVfHCCCYm8DDYKPzL5w4nCtobiZmSr",
  commodities: JSON.stringify([
    {
      commodity: "XTZ",
      network: "tezos",
    },
  ]),
});
```

--------------------------------

### Add Listeners to Wert Widget (JavaScript)

Source: https://docs.wert.io/docs/listerners-object

Demonstrates how to initialize the WertWidget with a listeners object to handle events. The example shows adding a 'position' event listener that logs the current step to the console. This is a fundamental pattern for integrating event handling into the widget.

```javascript
const widget = new WertWidget({
  ...options,
  listeners: {
    position: (data) => console.log("step:", data.step),
  },
});
```

--------------------------------

### Configure Wert.io Widget with Multiple Pre-filled Addresses (TypeScript)

Source: https://docs.wert.io/docs/extra-object-fiat-onramp

This example shows how to configure the Wert.io widget to display multiple cryptocurrencies with pre-filled wallet addresses. Users can switch between these cryptocurrencies, and their respective addresses will remain filled. This enhances the user experience by reducing manual input.

```typescript
const options: Options = {
  // ... other properties
  currency: 'USD',
  commodity: 'ETH',
  network: 'ethereum',
  
  extra: {
    wallets: [
      {
        name: "ETH", // case-ignored
        network: "ethereum", // case-ignored
        address: "0x0E976df9bb3ac63F7802ca843C9d121aE2Ef22ee",
      },
      {
        name: "XTZ", // case-ignored
        network: "tezos", // case-ignored
        address: "tz1LjQKVfHCCCYm8DDYKPzL5w4nCtobiZmSr",
      },
      {
        name: "MATIC", // case-ignored
        network: "polygon", // case-ignored
        address: "0x0E976df9bb3ac63F7802ca843C9d121aE2Ef22ee",
      },
    ],
  },
};
```

--------------------------------

### Encode Solana Instruction Data JSON

Source: https://docs.wert.io/docs/forming-input-data

This example shows the JSON structure for encoding Solana instruction data. It includes the program ID, a list of accounts with their properties (address, signer status, writability), and the serialized instruction data. This format is specific to Wert's SDK.

```json
{
  "program_id": "11111111111111111111111111111111",
  "accounts": [
    {
      "address": "BGCSawehjnxUDciqRCPfrXqzKvBeiTSe3mEtvTFC5d9q",
      "is_signer": true,
      "is_writable": true
    },
    {
      "address": "C8eRw3N4ysXgbqkjw4QmtT5ws5ByE9TYGsuepVMBkXCy",
      "is_signer": false,
      "is_writable": true
    }
  ],
  "data": "0200000000ca9a3b00000000"
}
```

--------------------------------

### Configure Wert.io Sandbox Testing Environment

Source: https://context7.com/context7/wert_io/llms.txt

Sets up a testing environment for Wert.io widget integration using sandbox credentials and mock data. This allows developers to test payment flows, event listeners, and different transaction scenarios without using real funds.

```javascript
import WertWidget from '@wert-io/widget-initializer';

// Sandbox configuration
const sandboxWidget = new WertWidget({
  partner_id: 'sandbox_partner_id',
  session_id: 'test_session_id',
  origin: 'https://sandbox.wert.io', // Critical for sandbox
  click_id: 'test_order_001',
  redirect_url: 'https://yourapp.com/test',
  // Prefill test data
  email: 'test@example.com',
  phone: '+1234567890', // Any phone number works
  country_of_residence: 'US',
  listeners: {
    'payment-status': (data) => {
      console.log('Sandbox payment:', data);
    }
  }
});

// Test addresses (use these to avoid returning tokens)
const TEST_ADDRESSES = {
  EVM: '0x2ff0ec69341f43cc462251bd49bb63681adafcb0',
  Tezos: 'tz1T2uyYTshSGrEg13VGJFqsWwbi2H175hZb',
  Solana: 'BGCSawehjnxUDciqRCPfrXqzKvBeiTSe3mEtvTFC5d9q'
};

// Mock card CVV codes for different responses
const CVV_CODES = {
  SUCCESS: '123', // Any code except below
  GENERAL_FAILURE: '400',
  DECLINED: '401',
  INCORRECT_DETAILS: '402',
  LIMITS_EXCEEDED: '403',
  INSUFFICIENT_FUNDS: '404',
  INCORRECT_CVV: '405',
  CARD_VALIDATION_FAILED: '406',
  CONTACT_SUPPORT: '407'
};

// SMS verification code is always '0000' in sandbox

sandboxWidget.open();

```

--------------------------------

### GET /api/external/users

Source: https://docs.wert.io/docs/data-api

Retrieves information about users associated with the Partner ID.

```APIDOC
## GET /api/external/users

### Description
Retrieves information about users associated with the Partner ID.

### Method
GET

### Endpoint
`https://partner.wert.io/api/external/users` (Production)
`https://partner-sandbox.wert.io/api/external/users` (Sandbox)

### Headers
- **X-API-KEY** (string) - Required - Your unique API key.

### Query Parameters
- **limit** (Number) - Optional - The number of users to retrieve. Defaults to 10.
- **offset** (Number) - Optional - Skips the specified number of users. Defaults to 0.
- **user_id** (String) - Optional - Filter users by a specific user ID.

### Request Example
```shell
curl -X GET 'https://partner.wert.io/api/external/users' \
-H 'X-API-KEY: your-unique-api-key'
```

### Response
#### Success Response (200)
- **success** (Boolean) - Whether the request was successfully processed.
- **data** (Array of Objects) - An array containing user objects.
  - **user_id** (String) - Unique identifier for the user.
  - **name** (String) - Name of the user.
  - **email** (String) - Email address of the user.
  - **created_at** (String) - Timestamp when the user was created.
- **total** (Number) - The total number of users matching the criteria.

#### Response Example
```json
{
    "success": true,
    "data": [
        {
            "user_id": "01HNWWXZ8FQ9FSH08A8ACHH7K1",
            "name": "Jane Doe",
            "email": "jane.doe@example.com",
            "created_at": "2024-02-01 10:00:00"
        }
    ],
    "total": 1
}
```
```

--------------------------------

### GET /api/external/orders

Source: https://docs.wert.io/docs/data-api

Retrieves a list of orders associated with the Partner ID. Supports filtering and sorting through query parameters.

```APIDOC
## GET /api/external/orders

### Description
Retrieves a list of orders associated with the Partner ID. Supports filtering and sorting through query parameters.

### Method
GET

### Endpoint
`https://partner.wert.io/api/external/orders` (Production)
`https://partner-sandbox.wert.io/api/external/orders` (Sandbox)

### Headers
- **X-API-KEY** (string) - Required - Your unique API key.

### Query Parameters
- **limit** (Number) - Optional - The number of orders to retrieve. Defaults to 10.
- **offset** (Number) - Optional - Skips the specified number of orders. Defaults to 0.
- **search_by** (String) - Optional - Allows setting an order or click ID to find a specific order.
- **order_by** (String: `asc` / `desc`) - Optional - Allows setting the order as ascending or descending. Defaults to `desc`.

### Request Example
```shell
curl -X GET 'https://partner.wert.io/api/external/orders' \
-H 'X-API-KEY: your-unique-api-key'
```

```shell
curl -X GET -G 'https://partner.wert.io/api/external/orders' \
-H 'X-API-KEY: your-unique-api-key' \
-d 'limit=20' \
-d 'offset=10' \
-d 'order_by=asc'
```

```shell
curl -X GET -G 'https://partner.wert.io/api/external/orders' \
-H 'X-API-KEY: your-unique-api-key' \
-d 'search_by=click_id'
```

### Response
#### Success Response (200)
- **success** (Boolean) - Whether the request was successfully processed.
- **data** (Array of Objects) - An array containing the retrieved orders.
  - **order_id** (String) - Unique identifier for the order.
  - **click_id** (String) - Identifier for the click associated with the order.
  - **currency** (String) - The currency of the transaction.
  - **currency_amount** (Number) - The amount in the transaction currency.
  - **crypto** (String) - The cryptocurrency involved.
  - **crypto_amount** (Number) - The amount in cryptocurrency.
  - **user_id** (String) - Identifier for the user.
  - **status** (String) - The status of the order (e.g., 'success', 'failed').
  - **card_id** (String) - Identifier for the card used.
  - **created_at** (String) - Timestamp when the order was created.
  - **changed_at** (String) - Timestamp when the order was last changed.
  - **tx_id** (String) - Transaction ID.
  - **card_brand** (String) - Brand of the card used.
  - **fail_reason** (String) - Reason for failure, if applicable.
  - **payment_type** (String) - Type of payment.
  - **additional_data** (Object or null) - Additional data related to the order.
- **total** (Number) - The total number of orders matching the criteria.

#### Response Example
```json
{
    "success": true,
    "data": [
        {
            "order_id": "01HNWX0HSK85WW9W5A3RZS1BBH",
            "click_id": "82960ad6-e52c-48b1-9293-5658709da384",
            "currency": "usd",
            "currency_amount": 1.07,
            "crypto": "matic.simple.polygon",
            "crypto_amount": 1.28928444,
            "user_id": "01HNWWXZ8FQ9FSH08A8ACHH7K1",
            "status": "success",
            "card_id": "01HNWWZ6E1T0BJT46H35M42JT7",
            "created_at": "2024-02-05 15:08:29",
            "changed_at": "2024-02-05 15:08:32",
            "tx_id": "0xbef4262a7c56f64423b80e4342ee4309595dcdb78d8c201fd752dc1d9c29c19e",
            "card_brand": "VISA",
            "fail_reason": "",
            "payment_type": "non_3ds",
            "additional_data": null
        }
    ],
    "total": 2
}
```
```

--------------------------------

### Wert Widget Initialization

Source: https://docs.wert.io/docs/fiat-onramp

Integrates the Wert Widget into your web application using the provided SDK. This is the recommended method for initializing the payment module.

```APIDOC
## Wert Widget Initialization

### Description
Initializes the Wert Widget in your web application using the official SDK. This provides a seamless user experience for payment processing.

### Method
JavaScript SDK Initialization

### Endpoint
N/A (Client-side integration)

### Parameters
#### Options (passed to WertWidget constructor)
- **partner_id** (string) - Required - Your unique partner identifier.
- **session_id** (string) - Required - The session ID obtained from the `/api/external/hpp/create-session` endpoint.
- **origin** (string) - Optional (Required in sandbox) - The origin URL for sandbox environments (e.g., 'https://sandbox.wert.io').

### Request Example
```javascript
// Import the SDK
import WertWidget from '@wert-io/widget-initializer';
import type { Options } from '@wert-io/widget-initializer/types';

// Initialize the payment module
const options: Options = {
  partner_id: 'YourPartnerID',
  session_id: 'SessionID', // session id recieved from partner.wert.io/api/
  origin: 'https://sandbox.wert.io', // this option needed only in sandbox
}
  
const wertWidget = new WertWidget(options);

wertWidget.open();

// Further code to handle widget events and interactions
```

### Response
N/A (Widget interaction occurs on the client-side)

```

--------------------------------

### Wert Widget Initialization (JavaScript)

Source: https://docs.wert.io/docs/fiat-onramp

This JavaScript snippet shows how to initialize the Wert Widget using the provided SDK. It requires partner_id and session_id, and an origin is needed for sandbox environments. The open() method is called to display the widget.

```JavaScript
// Import the SDK
import WertWidget from '@wert-io/widget-initializer';
import type { Options } from '@wert-io/widget-initializer/types';

// Initialize the payment module
const options: Options = {
partner_id: 'YourPartnerID',
session_id: 'SessionID', // session id recieved from partner.wert.io/api/
origin: 'https://sandbox.wert.io', // this option needed only in sandbox
}
  
const wertWidget = new WertWidget(options);

wertWidget.open();

// Further code to handle widget events and interactions
```

--------------------------------

### GET /api/external/orders

Source: https://context7.com/context7/wert_io/llms.txt

Fetches transaction history and order details for reconciliation. Supports filtering, pagination, and searching by click_id.

```APIDOC
## GET /api/external/orders

### Description
Fetches transaction history and order details for reconciliation. Supports filtering, pagination, and searching by click_id.

### Method
GET

### Endpoint
https://partner.wert.io/api/external/orders

### Parameters
#### Headers
- **X-API-KEY** (string) - Required - Your API key.

#### Query Parameters
- **limit** (integer) - Optional - The maximum number of orders to return. Default is 20.
- **offset** (integer) - Optional - The number of orders to skip. Default is 0.
- **order_by** (string) - Optional - The order of results ('asc' or 'desc').
- **search_by** (string) - Optional - Filter orders by a specific click_id.

### Request Example
```bash
# Get recent orders
curl -X GET 'https://partner.wert.io/api/external/orders' \
-H 'X-API-KEY: your_api_key_here'

# Get orders with pagination and filtering
curl -X GET -G 'https://partner.wert.io/api/external/orders' \
-H 'X-API-KEY: your_api_key_here' \
-d 'limit=20' \
-d 'offset=10' \
-d 'order_by=asc'

# Get specific order by click_id
curl -X GET -G 'https://partner.wert.io/api/external/orders' \
-H 'X-API-KEY: your_api_key_here' \
-d 'search_by=order_xyz_123'
```

### Response
#### Success Response (200)
- **orders** (array) - An array of order objects, each containing details like:
  - **order_id** (string) - Unique order ID.
  - **click_id** (string) - The click ID associated with the order.
  - **status** (string) - The status of the order (e.g., 'success', 'pending', 'failed').
  - **amount** (number) - The transaction amount.
  - **currency** (string) - The currency of the transaction.
  - **created_at** (string) - Timestamp of order creation.
  - **updated_at** (string) - Timestamp of last order update.

#### Response Example
```json
{
  "orders": [
    {
      "order_id": "ord_12345",
      "click_id": "order_xyz_123",
      "status": "success",
      "amount": 100.50,
      "currency": "USD",
      "created_at": "2023-10-27T10:00:00Z",
      "updated_at": "2023-10-27T10:05:00Z"
    }
  ]
}
```

#### Error Response (401 Unauthorized)
- **message** (string) - Error message indicating unauthorized access.
```json
{
  "message": "Unauthorized: API key is missing or invalid."
}
```
```

--------------------------------

### Get User Data API

Source: https://docs.wert.io/docs/data-api

This endpoint allows you to fetch detailed user data for users you have created or served. You can specify user IDs to retrieve specific user information.

```APIDOC
## GET /api/external/users

### Description
Fetches detailed user data for specified users.

### Method
GET

### Endpoint
https://partner.wert.io/api/external/users

### Parameters
#### Query Parameters
- **user_ids** (string) - Required - Comma-separated list of user IDs to retrieve.

#### Headers
- **X-Api-Key** (string) - Required - Your unique API key.
- **Content-Type** (string) - Required - application/json

### Request Example
```shell
curl -X GET 'https://partner.wert.io/api/external/users?user_ids=01JP7C3WV0BXEWP5ZF2Q8MQ7P0' \
  -H 'X-Api-Key: your-unique-api-key' \
  -H 'Content-Type: application/json'
```

### Response
#### Success Response (200)
- **data** (array) - An array of user objects.
  - **user_id** (string) - The unique identifier for the user.
  - **created_at** (string) - The timestamp when the user was created.
  - **country** (string) - The user's country. (Optional, do not send if empty)
  - **state** (string) - The user's state. (Optional, do not send if empty)
  - **phone** (string) - The user's phone number (masked).
  - **phone_country** (string) - The country code for the user's phone number.
  - **banned** (string) - Present only if the user is banned.
  - **lkyc_status** (string) - The status of the LKYC verification.
  - **fkyc_status** (string) - The status of the FKYC verification.
  - **limits** (object) - Spending limits for the user.
    - **crypto_spending** (number) - Total allowed crypto spending.
    - **crypto_remaining** (number) - Remaining crypto spending allowance.
    - **digital_goods_spending** (number) - Total allowed digital goods spending.
    - **digital_goods_remaining** (number) - Remaining digital goods spending allowance.
  - **linked_payment_methods** (array) - A list of the user's linked payment methods.
    - **method** (string) - The payment method type (e.g., 'bank_card').
    - **cards** (array) - Details of linked cards.
      - **card_id** (string) - The unique identifier for the card.
      - **brand** (string) - The card brand (e.g., 'Visa').
      - **last_digits** (string) - The last four digits of the card number.
      - **created_at** (string) - The timestamp when the card was linked.
- **success** (boolean) - Indicates if the request was successful.
- **total** (integer) - The total number of users returned.

#### Response Example
```json
{
    "data": [
        {
          "user_id": "01HPPKVTKC3VKXC95ADA8M5JTA",
          "created_at": "2019-05-15T12:30:45Z",
          "country": "US",
          "state": "CA",
          "phone": "+1*****345",
          "phone_country": "US",
          "banned": "",
          "lkyc_status": "success",
          "fkyc_status": "not initiated",
          "limits": {
            "crypto_spending": 1000.07,
            "crypto_remaining": 500.03,
            "digital_goods_spending": 0,
            "digital_goods_remaining": 1500
           },
				"linked_payment_methods": [
					  {
					    "method": "bank_card",
					    "cards": [
					      {
					        "card_id": "01HPPKVTHGGHHDA8M5JTA",
					        "brand": "Visa",
					        "last_digits": "4242",
					        "created_at": "2024-05-01T10:30:00Z"
					      },
					      {
					        "card_id": "01HPPKVTKC3VKXJBBBJ76",
					        "brand": "Mastercard",
					        "last_digits": "1111",
					        "created_at": "2024-05-10T14:20:00Z"
					      }
					    ]
					  }
					]
        }
    ],
    "success": true,
    "total": 1
}
```
```

--------------------------------

### POST /api/external/users/create

Source: https://context7.com/context7/wert_io/llms.txt

Creates users directly from backend with KYC data for automatic verification.

```APIDOC
## POST /api/external/users/create

### Description
Creates users directly from backend with KYC data for automatic verification.

### Method
POST

### Endpoint
https://partner.wert.io/api/external/users/create

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **has_accepted_terms_of_service** (boolean) - Required - Indicates if the user has accepted the terms of service.
- **phone** (string) - Required - The user's phone number.
- **email** (string) - Required - The user's email address.
- **first_name** (string) - Required - The user's first name.
- **middle_name** (string) - Optional - The user's middle name.
- **last_name** (string) - Required - The user's last name.
- **date_of_birth** (string) - Required - The user's date of birth (YYYY-MM-DD).
- **country_of_residence** (string) - Required - The user's country of residence.
- **state_of_residence** (string) - Required - The user's state of residence.

### Request Example
```json
{
  "has_accepted_terms_of_service": true,
  "phone": "+1234567890",
  "email": "john.doe@example.com",
  "first_name": "John",
  "middle_name": "Paul",
  "last_name": "Doe",
  "date_of_birth": "1990-01-01",
  "country_of_residence": "USA",
  "state_of_residence": "CA"
}
```

### Response
#### Success Response (201 Created)
- **user_id** (string) - The unique identifier for the created user.
- **created_at** (string) - The timestamp when the user was created.

#### Response Example
```json
{
  "user_id": "01HPPKVTKC3VKXC95ADA8M5JTA",
  "created_at": "2024-05-15T12:30:45Z"
}
```

#### Error Response (403 Forbidden)
- **message** (string) - Describes the reason for the forbidden access.

#### Error Response Example
```json
{
  "message": "Forbidden. Ensure the user is 18+ years old, country and state are supported, and user has accepted terms and conditions."
}
```
```

--------------------------------

### Create User - User Management API (Bash)

Source: https://context7.com/context7/wert_io/llms.txt

Creates a new user with KYC data via the User Management API. Requires an API key and sends user details in a JSON payload. Successful creation returns a user ID and creation timestamp. Errors may occur due to age, country, or terms of service violations.

```bash
curl -X POST 'https://partner.wert.io/api/external/users/create' \
-H 'X-Api-Key: your_api_key_here' \
-H 'Content-Type: application/json' \
-d '{
  "has_accepted_terms_of_service": true,
  "phone": "+1234567890",
  "email": "john.doe@example.com",
  "first_name": "John",
  "middle_name": "Paul",
  "last_name": "Doe",
  "date_of_birth": "1990-01-01",
  "country_of_residence": "USA",
  "state_of_residence": "CA"
}'
```

--------------------------------

### Open Wert.io Widget using JavaScript

Source: https://docs.wert.io/docs/widget-display-methods

Initializes and mounts the Wert.io widget as an iframe in the DOM, making it visible. This method is essential for displaying the widget to the user. It relies on the `wertWidget` object provided by the SDK.

```javascript
wertWidget.open();
```

--------------------------------

### Initialize NFT Checkout Widget - JavaScript

Source: https://context7.com/context7/wert_io/llms.txt

Initializes the Wert.io widget for NFT purchases or smart contract interactions by signing transaction data. This snippet demonstrates signing smart contract data and then initializing the widget with the signed payload.

```javascript
import WertWidget from '@wert-io/widget-initializer';
import { signSmartContractData } from '@wert-io/widget-sc-signer';
import { v4 as uuidv4 } from 'uuid';

// Sign smart contract data on backend
const signedData = signSmartContractData(
  {
    address: '0x96D5990185022212d367A0e09263B12Dbb4EE06A',
    commodity: 'ETH',
    network: 'ethereum',
    commodity_amount: 0.005,
    sc_address: '0x3b2305502bd6f8b1eb2ed474ac15c61c6702b18b',
    sc_input_data: '0x9dae76ea000000000000000000000000000000000000000000000000000000000000003700000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001'
  },
  privateKey // Stored securely on backend
);

// Initialize widget with signed data
const nftWidget = new WertWidget({
  partner_id: 'your_partner_id',
  origin: 'https://sandbox.wert.io',
  click_id: uuidv4(),
  redirect_url: 'https://yourapp.com/nft/success',
  ...signedData, // Includes signature, sc_address, sc_input_data
  listeners: {
    'payment-status': (data) => {
      if (data.status === 'success') {
        console.log('NFT minted, tx:', data.tx_id);
      }
    }
  }
});

nftWidget.open();
```

--------------------------------

### Create Payment Session - Full Restrict Flow (cURL)

Source: https://docs.wert.io/docs/fiat-onramp

This cURL example shows how to create a 'simple_full_restrict' payment session. It includes parameters like wallet_address, currency, commodity, network, and currency_amount. Note that only one of commodity_amount or currency_amount can be used.

```cURL
curl -X POST "https://partner-sandbox.wert.io/api/external/hpp/create-session" \
-H "X-Api-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "flow_type": "simple_full_restrict",
  "wallet_address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "currency": "USD",
  "commodity": "TT",
  "network": "amoy",
  "currency_amount": 100.50
}'
```

--------------------------------

### Create Fiat Onramp Session API - Bash

Source: https://context7.com/context7/wert_io/llms.txt

Generates a payment session for initializing the Wert.io widget to purchase cryptocurrency with fiat. Requires an API key and specifies transaction details like currency, amount, and user ID.

```bash
curl -X POST "https://partner-sandbox.wert.io/api/external/hpp/create-session" \
-H "X-Api-Key: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
  "flow_type": "simple_full_restrict",
  "wallet_address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "currency": "USD",
  "commodity": "ETH",
  "network": "sepolia",
  "currency_amount": 100.50,
  "user_id": "user_12345"
}'
```
Tokens:
Raw