Guardarian

https://docs.guardarian.com/
Admin
Guardarian is a non-custodial crypto payment platform that enables secure, account-free exchanges to...
Tokens:25,471
Snippets:361
Trust Score:10
Update:4 months ago
Show doc for...
Tokens:
Raw
### Example Request

Source: https://docs.guardarian.com/docs/exchange/v-1-b-2-b-min-max-range-from-to

Example of a GET request to retrieve min/max exchange amounts.

```http
GET 
## https://api-payments.guardarian.com/v1/b2b/min-max-range/:from_to
```

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

### Node.js Axios Example

Source: https://docs.guardarian.com/docs/exchange/v-1-b-2-b-estimate

Example of how to make a GET request to the /v1/b2b/estimate endpoint using Node.js and Axios.

```javascript
const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: 'https://api-payments.guardarian.com/v1/b2b/estimate',
  headers: {   
    'Accept': 'application/json',   
    'x-api-key': '<x-api-key>'
  }
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

```

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

### Node.js Axios Example

Source: https://docs.guardarian.com/docs/exchange/get-currency-by-ticker

Example of how to fetch currency details using Node.js with the Axios library.

```javascript
const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: 'https://api-payments.guardarian.com/v1/currencies/:ticker',
  headers: {
    'Accept': 'application/json'
  }
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

```

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

### Node.js Axios Example

Source: https://docs.guardarian.com/docs/exchange/v-1-b-2-b-min-max-range-from-to

Example of how to make the request using Node.js and Axios.

```javascript
const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: 'https://api-payments.guardarian.com/v1/b2b/min-max-range/:from_to',
  headers: {
    'Accept': 'application/json'
  }
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

```

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

### Node.js (Axios) Example

Source: https://docs.guardarian.com/docs/exchange/v-1-b-2-b-add-crypto-wallet

Example of how to add a crypto wallet using Node.js with Axios.

```javascript
const axios = require('axios');
let data = JSON.stringify({
  "currency": "USDT",
  "network": "BSC",
  "wallet_address": "0xd9c844e23cde35aaef5266b0cde66c99d8999999"
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://api-payments.guardarian.com/v1/b2b/add-crypto-wallet',
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    'x-api-key': '<x-api-key>'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

```

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

### Widget Custom Color Example

Source: https://docs.guardarian.com/docs/widget-integration

Example demonstrating custom widget colors and currency settings.

```url
https://guardarian.com/calculator/v1?partner_api_token=YOUR_API_KEY&theme=green&type=narrow&default_fiat_currency=DKK&body_background=lightpink&default_crypto_currency=ETH&to_network=BSC
```

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

### Node.js Axios Example

Source: https://docs.guardarian.com/docs/exchange/get-estimate

Example of how to use the /v1/estimate API with Node.js and Axios.

```javascript
const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: 'https://docs.guardarian.com/v1/estimate',
  headers: {
    'Accept': 'application/json',
    'x-api-key': '<x-api-key>'
  }
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

```

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

### Current flow example request

Source: https://docs.guardarian.com/docs/api-integration/getting-billing-info

This is an example of a request made during the current flow where users manually input their billing information.

```json
{
  "from_amount": 1200.24,
  "from_currency": "EUR",
  "to_currency": "BTC",
  "from_network": "EUR",
  "to_network": "BTC"
}
```

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

### Successful Operation Response Example (JSON)

Source: https://docs.guardarian.com/docs/exchange/get-crypto-currencies

An example of a successful JSON response when retrieving crypto currency data.

```json
[
  {
    "id": 7427617093,
    "currency_type": "CRYPTO",
    "ticker": "USDT",
    "name": "Tether",
    "enabled": true,
    "has_external_id": false,
    "is_featured": false,
    "is_stable": false,
    "is_available": true,
    "payment_methods": [
      {
        "type": "SEPA_1",
        "payment_category": "CRYPTO",
        "deposit_enabled": true,
        "withdrawal_enabled": true
      }
    ],
    "block_explorer_url_mask": null,
    "default_exchange_value": 10,
    "networks": [
      {
        "name": "Tether (ERC20)",
        "network": "ETH",
        "logo_url": "http://somesite.com/",
        "block_explorer_url_mask": null,
        "token_contract": null,
        "payment_methods": [
          {
            "type": "SEPA_1",
            "payment_category": "CRYPTO",
            "deposit_enabled": true,
            "withdrawal_enabled": true
          }
        ],
        "network_fee": 0.56
      }
    ]
  }
]
```

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

### GET Request Example

Source: https://docs.guardarian.com/docs/exchange/get-transaction-by-id

Example of how to retrieve transaction details using the transaction ID.

```http
GET
## https://api-payments.guardarian.com/v1/transaction/:id
```

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

### Example Response for 200 OK

Source: https://docs.guardarian.com/docs/exchange/get-currency-by-ticker

An example of a successful JSON response when retrieving details for the USDT currency.

```json
{
  "id": 7427617093,
  "currency_type": "CRYPTO",
  "ticker": "USDT",
  "name": "Tether",
  "enabled": true,
  "has_external_id": false,
  "is_featured": false,
  "is_stable": false,
  "is_available": true,
  "payment_methods": [
    {
      "type": "SEPA_1",
      "payment_category": "CRYPTO",
      "deposit_enabled": true,
      "withdrawal_enabled": true
    }
  ],
  "block_explorer_url_mask": null,
  "default_exchange_value": 10,
  "networks": [
    {
      "name": "Tether (ERC20)",
      "network": "ETH",
      "logo_url": "http://somesite.com/",
      "block_explorer_url_mask": null,
      "token_contract": null,
      "payment_methods": [
        {
          "type": "SEPA_1",
          "payment_category": "CRYPTO",
          "deposit_enabled": true,
          "withdrawal_enabled": true
        }
      ],
      "network_fee": 0.56
    }
  ]
}
```

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

### Node.js Axios GET Request Example

Source: https://docs.guardarian.com/docs/exchange/v-1-b-2-b-transactions

Example of how to make a GET request to the B2B transactions endpoint using Node.js and Axios.

```javascript
const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: 'https://api-payments.guardarian.com/v1/b2b/transactions',
  headers: {
    'Accept': 'application/json',
    'x-api-key': '<x-api-key>'
  }
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

```

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

### Node.js Axios Example

Source: https://docs.guardarian.com/docs/exchange/v-1-customer-by-shared-token

Example of how to create a new customer using the /v1/customer/by-shared-token endpoint with Node.js and Axios.

```javascript
const axios = require('axios');
let data = JSON.stringify({
  "email": "email@email.com",
  "kyc_shared_token": "_act-460a698b-d2bc-4cbc-9456-5f36fee38083",
  "kyc_shared_token_provider": "sumsub"
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://api-payments.guardarian.com/v1/customer/by-shared-token',
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    'x-api-key': '<x-api-key>'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

```

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

### Node.js Axios Example

Source: https://docs.guardarian.com/docs/exchange/v-1-countries-country-payment-categories

Example of how to make a GET request to the payment categories API using Node.js and Axios.

```javascript
const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: 'https://api-payments.guardarian.com/v1/countries/:country/payment-categories',
  headers: {
    'Accept': 'application/json'
  }
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

```

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

### Example Request

Source: https://docs.guardarian.com/docs/exchange/get-min-max-from-to

This example shows how to retrieve the minimum and maximum exchange amounts for a currency pair using Axios.

```javascript
const axios = require('axios');  
  
let config = {  
  method: 'get',  
  maxBodyLength: Infinity,  
  url: 'https://api-payments.guardarian.com/v1/market-info/min-max-range/:from_to',  
  headers: {   
    'Accept': 'application/json'  
  }  
};
  
axios.request(config)  
.then((response) => {  
  console.log(JSON.stringify(response.data));  
})  
.catch((error) => {  
  console.log(error);  
});  

```

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

### Node.js (Axios) Example

Source: https://docs.guardarian.com/docs/exchange/v-1-b-2-b-currencies

Example of how to fetch the list of supported currencies using Node.js with the Axios library.

```javascript
const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: 'https://api-payments.guardarian.com/v1/b2b/currencies',
  headers: {
    'Accept': 'application/json'
  }
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

```

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

### 200 OK Response Example

Source: https://docs.guardarian.com/docs/exchange/v-1-b-2-b-currencies

Example of a successful response when retrieving a list of supported currencies.

```json
{
  "crypto_currencies": [
    {
      "id": 7427617093,
      "currency_type": "CRYPTO",
      "ticker": "USDT",
      "name": "Tether",
      "enabled_b2b": true,
      "default_exchange_value": 10,
      "networks": [
        {
          "id": 7427617099,
          "name": "Tether (ERC20)",
          "network": "ETH",
          "enabled_b2b": true,
          "payment_methods": "SEPA_1"
        }
      ]
    }
  ],
  "fiat_currencies": [
    {
      "id": "5517577077",
      "currency_type": "FIAT",
      "ticker": "EUR",
      "name": "Euro",
      "enabled_b2b": true,
      "default_exchange_value": 300,
      "networks": [
        {
          "id": 7427617099,
          "name": "Euro",
          "network": "EUR",
          "enabled_b2b": true,
          "payment_methods": [
            {
              "type": "SEPA_1",
              "payment_category": "CRYPTO",
              "deposit_enabled": true,
              "withdrawal_enabled": true
            }
          ]
        }
      ]
    }
  ]
}
```

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

### Node.js Axios example

Source: https://docs.guardarian.com/docs/exchange/v-1-b-2-b-payout-addresses

Example of how to call the API using Node.js with Axios.

```javascript
const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: 'https://api-payments.guardarian.com/v1/b2b/payout-addresses',
  headers: {
    'Accept': 'application/json',
    'x-api-key': '<x-api-key>'
  }
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

```

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

### Example Response (200 OK)

Source: https://docs.guardarian.com/docs/exchange/v-1-payment-categories

This is an example of a successful response when retrieving payment categories.

```json
[
  {
    "id": 1,
    "name": "Visa/MasterCard",
    "category": "VISA_MC"
  }
]
```

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

### Payment in a New Window Example

Source: https://docs.guardarian.com/docs/widget-integration

Example of configuring the widget to open payments in a new tab and setting various user details and redirect URLs.

```url
https://guardarian.com/calculator/v1?partner_api_token=YOUR_API_KEY&theme=blue&type=wide&create_nav_behaviour=new_tab&email=michael.smith@example.com&first_name=Anna&last_name=Taylor&post_index=12345&country_alpha_2=GR&redirects_successful=https://example.com/thankyou
```

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

### Node.js (Axios) Example

Source: https://docs.guardarian.com/docs/exchange/get-transaction-by-id

Example of how to retrieve a transaction by ID using Node.js and the Axios library.

```javascript
const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: 'https://api-payments.guardarian.com/v1/transaction/:id',
  headers: {
    'Accept': 'application/json',
    'x-api-key': '<x-api-key>'
  }
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

```

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

### Successful operation example

Source: https://docs.guardarian.com/docs/exchange/v-1-b-2-b-payout-addresses

Example of a successful response when retrieving payout addresses.

```json
{
  "crypto_addresses": [
    {
      "coin": "XRP",
      "address": "rJ9n7pd14ixFc9cgGLc55Y8vQGvw2kkQud",
      "status": "Verified",
      "created_at": "2019-04-18T13:39:27.982Z"
    }
  ],
  "bank_addresses": [
    {
      "bic/swift": "REVOGBXX",
      "address": "GB18REVO99999999999999",
      "status": "Verified",
      "created_at": "2019-04-18T13:39:27.982Z"
    }
  ]
}
```

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

### Example URL with Parameters

Source: https://docs.guardarian.com/docs/api-integration/transaction-link

An example of a URL constructed with various query parameters to initiate a transaction.

```url
https://payments.guardarian.com/?api_key=xxxx-xxxx-xxxx-xxxx&from_currency=EUR&from_amount=1000&to_currency=XRP&to_network=XRP&redirects_successful=https://google.com
```

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

### Example Response for 500 Internal Error

Source: https://docs.guardarian.com/docs/exchange/get-currency-by-ticker

An example of an error response indicating an internal server error.

```json
{
  "statusCode": 500,
  "code": "INTERNAL_ERROR",
  "message": "The server encountered an internal error"
}
```

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

### Example: Getting an Estimate

Source: https://docs.guardarian.com/docs/api-integration/customer-country

Shows how to use the customer_country query parameter in a GET request for obtaining an estimate.

```http
GET /v1/estimate?from_currency=EUR&to_currency=BTC&from_amount=100&customer_country=US  

```

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

### New flow example request with billing_info

Source: https://docs.guardarian.com/docs/api-integration/getting-billing-info

This is an example of a request using the new flow, where billing information is passed directly in the API call within the 'customer.billing_info' field.

```json
// POST /v1/transaction  

{
  "from_amount": 1200,
  "from_currency": "EUR",
  "to_currency": "BTC",
  "from_network": "EUR",
  "to_network": "BTC",
  "customer": {
    "contact_info": {
      "email": "email@email.com"
    },
    "billing_info": {
      "country_alpha_2": "US",
      "us_region_alpha_2": "CA",
      "region": "user's region",
      "city": "user's city",
      "street_address": "user's address",
      "apt_number": "123",
      "post_index": "123123",
      "first_name": "John",
      "last_name": "Doe",
      "date_of_birthday": "01.01.1991",
      "gender": "M"
    }
   }
  }
```

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

### Custom Widget with Orange Theme and EUR Amount Setting Example

Source: https://docs.guardarian.com/docs/widget-integration

Example of a custom widget with an orange theme, specific fiat and crypto currency settings, amount, background colors, and a success redirect URL.

```url
https://guardarian.com/calculator/v1?partner_api_token=YOUR_API_KEY&theme=orange&type=narrow&fiat_currencies_list=%5B%7B%22ticker%22%3A%22EUR%22%2C%22network%22%3A%22EUR%22%7D%5D&crypto_currencies_list=%5B%7B%22ticker%22%3A%22ETH%22%2C%22network%22%3A%22ETH%22%7D%5D&from_amount=555&calc_background=orange&button_background=hex_ff4500&redirects_successful=https://example.com/success
```

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

### Example Request (axios)

Source: https://docs.guardarian.com/docs/exchange/v-1-payment-categories-category-countries

This code snippet demonstrates how to make a GET request to the /v1/payment-categories/{category}/countries endpoint using the axios library in Node.js.

```javascript
const axios = require('axios');  
  
let config = {  
  method: 'get',  
  maxBodyLength: Infinity,  
  url: 'https://api-payments.guardarian.com/v1/payment-categories/:category/countries',  
  headers: {   
    'Accept': 'application/json'  
  }  
};
  
axios.request(config)  
.then((response) => {  
  console.log(JSON.stringify(response.data));  
})  
.catch((error) => {  
  console.log(error);  
});  
```

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

### Transaction Response Example

Source: https://docs.guardarian.com/docs/exchange/get-transaction-by-id

An example of a successful transaction response, including details like ID, status, currency information, amounts, and timestamps.

```json
{
  "id": 5517577077,
  "status": "new",
  "email": "example@test.com",
  "errors": [
    {
      "code": "customer_blocked_by_risk_control",
      "reason": "Customer 5196934097 was blocked by risk control"
    }
  ],
  "status_details": null,
  "from_currency": "EUR",
  "initial_from_currency": "EUR",
  "from_network": "EUR",
  "from_currency_with_network": "EUR",
  "from_amount": 1200.24,
  "deposit_type": "SEPA_1",
  "payout_type": "CRYPTO",
  "expected_from_amount": 1200.24,
  "initial_expected_from_amount": 1200.24,
  "to_currency": "BTC",
  "to_network": "BTC",
  "to_currency_with_network": "Bitcoin",
  "to_amount": 0.144,
  "output_hash": "6146ccf6a66d994f7c363db875e31ca35581450a4bf6d3be6cc9ac79233a69d0",
  "expected_to_amount": 0.144,
  "location": "Somewhere",
  "created_at": "2019-04-18T13:39:27.982Z",
  "updated_at": "2019-04-18T13:39:27.982Z",
  "partner_id": 2517577071,
  "external_partner_link_id": "3245324",
  "from_amount_in_eur": 1200.24
```

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

### Node.js Axios Example

Source: https://docs.guardarian.com/docs/exchange/v-1-payment-categories

Example of how to fetch payment categories using Node.js with the Axios library.

```javascript
const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: 'https://api-payments.guardarian.com/v1/payment-categories',
  headers: {
    'Accept': 'application/json'
  }
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

```

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

### New Transaction Callback Example

Source: https://docs.guardarian.com/docs/webhooks

Callback data for a 'new' transaction event, indicating a transaction has been triggered and started.

```json
{
  "id": "5211023988",
  "email": null,
  "errors": [],
  "status": "new",
  "location": "DE",
  "to_amount": null,
  "created_at": "2025-11-07T11:57:34.880Z",
  "partner_id": "6269619154",
  "to_network": "BSC",
  "updated_at": "2025-11-07T11:57:34.902Z",
  "from_amount": "0",
  "output_hash": null,
  "payout_type": "CN_CUSTODY",
  "to_currency": "USDT",
  "deposit_type": "VISA_MC6",
  "from_network": "EUR",
  "from_currency": "EUR",
  "refund_reason": "",
  "status_reason": "",
  "status_details": null,
  "estimate_breakdown": {
    "toAmount": "221.77521931793637",
    "fromAmount": 200,
    "networkFee": {
      "amount": "0.05825908",
      "currency": "USDT"
    },
    "partnerFee": {
      "amount": "3.4",
      "currency": "EUR",
      "percentage": "1.7%"
    },
    "serviceFees": [
      {
        "name": "Service fee",
        "amount": "1",
        "currency": "EUR",
        "percentage": "0.5%"
      }
    ],
    "convertedAmount": {
      "amount": "199",
      "currency": "EUR"
    },
    "estimatedExchangeRate": "1.10887610"
  },
  "expected_to_amount": "221.77521931793638",
  "from_amount_in_eur": "200",
  "expected_from_amount": "200",
  "initial_from_currency": "EUR",
  "payout_payment_category": "CRYPTO",
  "deposit_payment_category": "VISA_MC",
  "external_partner_link_id": "01K9F2VP40115MYTXTAF814ES0",
  "to_currency_with_network": "Tether (Binance Smart Chain)",
  "from_currency_with_network": "Euro",
  "initial_expected_from_amount": "200",
  "version": "1.0",
  "requesterType": "EXCHANGE"
}
```

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

### Node.js Axios Example

Source: https://docs.guardarian.com/docs/exchange/v-1-b-2-b-transaction

Example of how to make a B2B transaction request using Node.js and Axios.

```javascript
const axios = require('axios');
let data = JSON.stringify({
  "from_amount": 1200.24,
  "from_currency": "EUR",
  "to_currency": "USDT",
  "from_network": null,
  "to_network": "ETH",
  "payout_account_address": "0x123213123C9b231231230AF21123"
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://api-payments.guardarian.com/v1/b2b/transaction',
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    'x-api-key': '<x-api-key>'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

```

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

### Node.js Axios Example

Source: https://docs.guardarian.com/docs/exchange/v-1-customer-id-status

Example of how to call the customer status API using Node.js with Axios.

```javascript
const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: 'https://api-payments.guardarian.com/v1/customer/:id/status',
  headers: {
    'Accept': 'application/json',
    'x-api-key': '<x-api-key>'
  }
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

```

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

### Successful operation (200)

Source: https://docs.guardarian.com/docs/exchange/v-1-b-2-b-min-max-range-from-to

Schema and example for a successful response.

```json
{
  "from": "EUR",
  "to": "BTC",
  "min": 50,
  "max": 300
}
```

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

### Deposit Callback Data Example

Source: https://docs.guardarian.com/docs/webhooks

Example of callback data for a deposit event.

```json
{
  "deposit_type": "REVOLUT",
  "from_network": "EUR",
  "from_currency": "EUR",
  "refund_reason": "",
  "status_reason": "",
  "payout_address": " ",
  "status_details": null,
  "expected_to_amount": "292.969604",
  "from_amount_in_eur": "285",
  "expected_from_amount": "285",
  "initial_from_currency": "EUR",
  "payout_payment_category": "CRYPTO",
  "deposit_payment_category": "REVOLUT_PAY",
  "external_partner_link_id": " ",
  "to_currency_with_network": "USD Coin",
  "from_currency_with_network": "Euro",
  "initial_expected_from_amount": "285"
},
"version": "1.0",
"requesterType": "EXCHANGE"
}
```

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

### Node.js Axios Example

Source: https://docs.guardarian.com/docs/exchange/get-fiat-currencies

Example of how to fetch fiat currencies using Node.js with the Axios library.

```javascript
const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: 'https://api-payments.guardarian.com/v1/currencies/fiat',
  headers: {
    'Accept': 'application/json'
  }
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

```

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

### Finished Event Callback Data Example

Source: https://docs.guardarian.com/docs/webhooks

Example of callback data for a 'Finished' event.

```json
{
  "payload": {
    "id": "6093711135",
    "email": null,
    "errors": [],
    "status": "finished",
    "location": "PE",
    "to_amount": "0.75408722",
    "created_at": "2025-03-07T02:04:08.439Z",
    "partner_id": " ",
    "to_network": "SOL",
    "updated_at": "2025-03-07T02:11:51.251Z",
    "from_amount": "419.24",
    "output_hash": " ",
    "payout_type": "CRYPTO_THROUGH_CN",
    "to_currency": "SOL",
    "deposit_type": "VISA_MC5",
    "from_network": "PEN",
    "from_currency": "PEN",
    "refund_reason": "",
    "status_reason": "",
    "payout_address": " ",
    "status_details": null,
    "expected_to_amount": "0.7607362049013585",
    "from_amount_in_eur": "106.35651492776119838",
    "expected_from_amount": "419.24",
    "initial_from_currency": "PEN",
    "payout_payment_category": "CRYPTO",
    "deposit_payment_category": "APPLE_PAY",
    "external_partner_link_id": " ",
    "to_currency_with_network": "Solana",
    "from_currency_with_network": "Sol",
    "initial_expected_from_amount": "419.24"
  },
  "version": "1.0",
  "requesterType": "EXCHANGE"
}
```

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

### Example Request

Source: https://docs.guardarian.com/docs/exchange/v-1-countries-country-payment-categories

Example of how to retrieve payment categories for a specific country using the Guardarian API.

```http
GET
## https://api-payments.guardarian.com/v1/countries/:country/payment-categories
```

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

### Example B2B Transactions Response (200 OK)

Source: https://docs.guardarian.com/docs/exchange/v-1-b-2-b-transactions

This is an example of a successful response when retrieving B2B transactions.

```json
[
  {
    "id": 5517577077,
    "status": "WAITING_FOR_DEPOSIT",
    "from_currency": "EUR",
    "from_network": null,
    "from_amount": 1200.24,
    "expected_from_amount": 1200.24,
    "to_currency": "BTC",
    "to_network": "BNB",
    "to_amount": 0.144,
    "expected_to_amount": 0.144,
    "created_at": "2019-04-18T13:39:27.982Z",
    "updated_at": "2019-04-18T13:39:27.982Z",
    "partner_id": 2517577071
  }
]
```

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

### Not found

Source: https://docs.guardarian.com/docs/exchange/v-1-customer-id-status

This is the schema and an example of a not found error response (404).

```json
{
  "statusCode": 404,
  "code": "NOT_FOUND",
  "message": "Not found"
}
```

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

### Skipping payment method flow request example

Source: https://docs.guardarian.com/docs/api-integration/skip-payment-method-flow

Example request demonstrating the new flow with the 'deposit' block to preselect a payment method category.

```json
{
  "from_amount": 1200.24,
  "from_currency": "EUR",
  "to_currency": "BTC",
  "from_network": "EUR",
  "to_network": "BTC",
  "deposit": {
    "payment_category": "VISA_MC",
    "skip_choose_payment_category": true
  }
}
```

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

### Example Response (200 OK)

Source: https://docs.guardarian.com/docs/exchange/get-fiat-currencies

An example of a successful JSON response when retrieving fiat currencies.

```json
[
  {
    "id": 5517577077,
    "currency_type": "FIAT",
    "ticker": "EUR",
    "name": "Euro",
    "enabled": true,
    "has_external_id": false,
    "is_featured": true,
    "is_stable": true,
    "is_available": true,
    "payment_methods": [
      {
        "type": "SEPA_1",
        "payment_category": "CRYPTO",
        "deposit_enabled": true,
        "withdrawal_enabled": true
      }
    ],
    "block_explorer_url_mask": null,
    "default_exchange_value": 300,
    "networks": [
      {
        "name": "Euro",
        "network": "EUR",
        "block_explorer_url_mask": null,
        "logo_url": "http://somesite.com/",
        "token_contract": null,
        "payment_methods": [
          {
            "type": "SEPA_1",
            "payment_category": "CRYPTO",
            "deposit_enabled": true,
            "withdrawal_enabled": true
          }
        ]
      }
    ]
  }
]
```

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

### Gradient Theme Widget with Initial Amount of 1000 USD

Source: https://docs.guardarian.com/docs/widget-integration

This example shows how to configure the widget with a gradient theme, a specific initial amount, and currency lists.

```url
https://guardarian.com/calculator/v1?partner_api_token=YOUR_API_KEY&theme=gradient&type=narrow&fiat_currencies_list=%5B%7B%22ticker%22%3A%22EUR%22%2C%22network%22%3A%22EUR%22%7D%5D&crypto_currencies_list=%5B%7B%22ticker%22%3A%22ETH%22%2C%22network%22%3A%22ETH%22%7D%5D&from_amount=555&switchable=true&button_background=rgb(255,105,180)&calc_background=rgb(255,20,147)&redirects_cancelled=https://example.com/cancelled
```

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

### Get Crypto Currencies API Request (Node.js with Axios)

Source: https://docs.guardarian.com/docs/exchange/get-crypto-currencies

Example of how to make a GET request to the crypto currencies endpoint using Node.js and the Axios library.

```javascript
const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: 'https://api-payments.guardarian.com/v1/currencies/crypto',
  headers: { 
    'Accept': 'application/json'
  }
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

```

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

### Widget "Without Shadows", 50 EUR and Other Parameters

Source: https://docs.guardarian.com/docs/widget-integration

This example demonstrates configuring the widget with specific themes, default currencies, amounts, and disabling shadows.

```url
https://guardarian.com/calculator/v1?partner_api_token=YOUR_API_KEY&theme=orange&type=narrow&default_crypto_currency=BTC&default_fiat_currency=EUR&default_from_amount=50&switchable=false&from_network=BTC&skip_choose_payment_category=false&skip_choose_payout_address=false&calc_background=crimson&button_background=purple&button_background_disabled=purple&widget_height=600&without_box_shadow=true&redirects_successful=https://example.com/success&active_tab_background=crimson&active_tab_color=white&select_background=black&select_color=white&submit_button_color=purple
```

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

### Successful Response Example

Source: https://docs.guardarian.com/docs/exchange/get-transaction-by-id

This JSON object represents a successful response when retrieving transaction details.

```json
{
  "customer_payout_address_changeable": true,
  "estimate_breakdown": {
    "toAmount": 0.036606,
    "fromAmount": 1000.24,
    "serviceFees": [
      {
        "name": "Service fee",
        "amount": "2.5",
        "currency": "EUR"
      }
    ],
    "convertedAmount": {
      "amount": 997.74,
      "currency": "EUR"
    },
    "estimatedExchangeRate": 0.0000366,
    "networkFee": {
      "amount": 0.00000267,
      "currency": "BTC"
    },
    "partnerFee": {
      "amount": 12.0024,
      "currency": "EUR",
      "percentage": "1%"
    }
  },
  "payout": {
    "address": "0x690b9a9e9aa1c9db991c7721a92d351db4fac990",
    "extra_id": "78239832980"
  },
  "deposit_payment_category": "CRYPTO",
  "payout_payment_category": "CRYPTO"
}
```

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

### Get Currencies API Request (Axios)

Source: https://docs.guardarian.com/docs/exchange/get-currencies

Example of how to fetch the list of currencies using the Guardarian API with Axios in Node.js.

```javascript
const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: 'https://api-payments.guardarian.com/v1/currencies',
  headers: {
    'Accept': 'application/json'
  }
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

```

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

### API Response Schema for Currencies

Source: https://docs.guardarian.com/docs/exchange/get-currencies

This is an example of the JSON response structure for the get currencies endpoint, detailing crypto and fiat currencies.

```json
{
  "crypto_currencies": [
    {
      "id": 7427617093,
      "currency_type": "CRYPTO",
      "ticker": "USDT",
      "name": "Tether",
      "enabled": true,
      "has_external_id": false,
      "is_featured": false,
      "is_stable": false,
      "is_available": true,
      "payment_methods": [
        {
          "type": "SEPA_1",
          "payment_category": "CRYPTO",
          "deposit_enabled": true,
          "withdrawal_enabled": true
        }
      ],
      "block_explorer_url_mask": null,
      "default_exchange_value": 10,
      "networks": [
        {
          "name": "Tether (ERC20)",
          "network": "ETH",
          "logo_url": "http://somesite.com/",
          "block_explorer_url_mask": null,
          "token_contract": null,
          "payment_methods": [
            {
              "type": "SEPA_1",
              "payment_category": "CRYPTO",
              "deposit_enabled": true,
              "withdrawal_enabled": true
            }
          ],
          "network_fee": 0.56
        }
      ]
    }
  ],
  "fiat_currencies": [
    {
      "id": 5517577077,
      "currency_type": "FIAT",
      "ticker": "EUR",
      "name": "Euro",
      "enabled": true,
      "has_external_id": false,
      "is_featured": true,
      "is_stable": true,
      "is_available": true,
      "payment_methods": [
        {
          "type": "SEPA_1",
          "payment_category": "CRYPTO",
          "deposit_enabled": true,
          "withdrawal_enabled": true
        }
      ],
      "block_explorer_url_mask": null,
      "default_exchange_value": 300,
      "networks": [
        {
          "name": "Euro",
          "network": "EUR",
          "block_explorer_url_mask": null,
          "logo_url": "http://somesite.com/",
          "token_contract": null,
          "payment_methods": [
            {
              "type": "SEPA_1",
              "payment_category": "CRYPTO",
              "deposit_enabled": true,
              "withdrawal_enabled": true
            }
          ]
        }
      ]
    }
  ]
}
```

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

### Node.js Axios Example

Source: https://docs.guardarian.com/docs/exchange/v-1-b-2-b-add-bank-account

This code snippet demonstrates how to register a bank account using Node.js with the Axios library.

```javascript
const axios = require('axios');
let data = JSON.stringify({
  "payment_category": "SEPA",
  "address": {
    "account_name": "Guardarian",
    "account_number": "XXXXXX000000001387753281",
    "swift": "Swift"
  },
  "intermediary_address": {
    "bank_name": "Bankname",
    "bank_address": "Bank address",
    "bank_country": "ET",
    "swift_bic_number": "Swift"
  }
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://api-payments.guardarian.com/v1/b2b/add-bank-account',
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    'x-api-key': '<x-api-key>'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

```

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

### Get available currencies for a payment category

Source: https://docs.guardarian.com/docs/api-integration/skip-payment-method-flow

API endpoint and example response to retrieve a list of supported currencies for a selected payment category.

```javascript
// GET "/v1/currencies/fiat?payment_category=<category>"

// Example response:  

[
  {
    "ticker": "EUR",
    // <...>
  },
  {
    "ticker": "USD",
    // <...>
  }
]
```

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

### Request Body Example

Source: https://docs.guardarian.com/docs/exchange/v-1-b-2-b-transaction

An example of the transaction object required in the request body.

```json
{
  "from_amount": 1200.24,
  "from_currency": "EUR",
  "to_currency": "USDT",
  "from_network": null,
  "to_network": "ETH",
  "payout_account_address": "0x123213123C9b231231230AF21123"
}
```

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

### Get All Transactions API Endpoint

Source: https://docs.guardarian.com/docs/exchange/get-all-transactions

This is the API endpoint for retrieving all transactions.

```bash
GET /v1/transactions
```

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

### Generate shareToken endpoint

Source: https://docs.guardarian.com/docs/api-integration/shared-kyc

Example of how to generate a shareToken using SumSub's internal API.

```bash
curl -X POST 'https://api.sumsub.com/resources/accessTokens/-/shareToken?applicantId=5ce412012b4da877b2d910bd&forClientId=CoolCoinLtd'
```

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

### Invalid token error example

Source: https://docs.guardarian.com/docs/exchange/v-1-b-2-b-payout-addresses

Example of an error response when an invalid token is provided.

```json
{
  "statusCode": 401,
  "code": "INVALID_TOKEN",
  "message": "Invalid token"
}
```
Tokens:
Raw