# External Exchange Rates

Brokers can integrate their preferred exchange rate source directly into the CRM and have greater control and accuracy over their currency conversion rates.

### <mark style="color:red;">Permission Rights</mark>

To begin setting up the exchange rate source, you will need to ensure you have the respective permissions:&#x20;

* **Read External Exchange Rates**: View external exchange rate settings.
* **Create External Exchange Rates**: Create new external exchange rate settings.
* **Update External Exchange Rates**: Update existing external exchange rate settings.
* **Delete External Exchange Rates**: Delete existing external exchange rate settings.

<figure><img src="https://1412218885-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjte3ihj30mTFvqCasyX%2Fuploads%2Fc8r1J7FKALnGoMU8bY96%2Fimage.png?alt=media&#x26;token=48f10e39-07cb-467f-91ae-16d5e8f35ddf" alt=""><figcaption></figcaption></figure>

### <mark style="color:red;">External Exchange Rate Operations</mark>

Once the respective permissions have been granted, you will be able to perform the following functions:&#x20;

<details>

<summary>Create New External Exchange Rate</summary>

To create new external exchange rate, follow these steps:&#x20;

1. Navigate to Transaction Settings > External Exchange Rates.&#x20;
2. Click "Create". <br>

   <figure><img src="https://1412218885-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjte3ihj30mTFvqCasyX%2Fuploads%2F7uikLB9IX2DJBINW1wyH%2Fimage.png?alt=media&#x26;token=3cc837ba-1c2e-4bdf-beb1-1dd7bc3b11d3" alt=""><figcaption></figcaption></figure>
3. Fill in the Name and URL.&#x20;
4. The API Key will be automatically generated. You can modify the API Key as needed for the external exchange rate source you are integrating.&#x20;
5. Click "Save". <br>

   <figure><img src="https://1412218885-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjte3ihj30mTFvqCasyX%2Fuploads%2F10mrpd09JIzvTvezb0Du%2Fimage.png?alt=media&#x26;token=cbc30516-e322-44bf-9176-261c7490b5e5" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>View External Exchange Rate</summary>

To view the settings of External Exchange Rate, follow these steps:&#x20;

1. Locate the external exchange rate you wish to view.&#x20;
2. Click the "View" icon. <br>

   <figure><img src="https://1412218885-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjte3ihj30mTFvqCasyX%2Fuploads%2FLdgmYakZE9VfLVMmsXhW%2Fimage.png?alt=media&#x26;token=3b8286b6-ddde-45ba-b810-d37367711841" alt=""><figcaption></figcaption></figure>
3. The details will be displayed accordingly. <br>

   <figure><img src="https://1412218885-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjte3ihj30mTFvqCasyX%2Fuploads%2FLv7Znf1gwH2L7eqmvvjx%2Fimage.png?alt=media&#x26;token=1acea192-9e12-461f-843e-9e1fb68beed6" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Edit External Exchange Rate</summary>

To edit the settings of External Exchange Rate, follow these steps:&#x20;

1. Locate the external exchange rate you wish to modify.&#x20;
2. Click the "Edit" icon. <br>

   <figure><img src="https://1412218885-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjte3ihj30mTFvqCasyX%2Fuploads%2Fu6IfyK7jbx1cznB8bRYo%2Fimage.png?alt=media&#x26;token=bda18ba1-8e18-47e8-ac1d-9246a2e196c1" alt=""><figcaption></figcaption></figure>
3. Amend the respective fields.&#x20;
4. Click "Save". <br>

   <figure><img src="https://1412218885-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjte3ihj30mTFvqCasyX%2Fuploads%2FxhD6CutRfQD1Lj5RpgJr%2Fimage.png?alt=media&#x26;token=511a79ce-5acd-4760-b0de-c825a0c1fca7" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Test External Exchange Rate </summary>

To test the integration of your external exchange rate, follow these steps:&#x20;

1. Locate the external exchange rate you wish to test.&#x20;
2. Click the "Test" icon. <br>

   <figure><img src="https://1412218885-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjte3ihj30mTFvqCasyX%2Fuploads%2F4NhsH70ldsA8aAHoBNUZ%2Fimage.png?alt=media&#x26;token=6177adac-9cd5-4c41-a554-a6cef23f2c01" alt=""><figcaption></figcaption></figure>
3. Fill in the Source Account Currency and Target Account Currency.&#x20;
4. Click "Test". <br>

   <figure><img src="https://1412218885-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjte3ihj30mTFvqCasyX%2Fuploads%2Fyh98Ym2c7g7dvrsxnkc6%2Fimage.png?alt=media&#x26;token=146666a3-72f6-4944-b718-d7d60d0444c7" alt=""><figcaption></figcaption></figure>
5. If the integration is successful, you will be able to view the exchange rate accordingly. <br>

   <figure><img src="https://1412218885-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjte3ihj30mTFvqCasyX%2Fuploads%2FtGFqQwfG4gGdrWevJrV2%2Fimage.png?alt=media&#x26;token=79c84675-6fa2-4a6c-8d19-9bbbe9960323" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Delete External Exchange Rate</summary>

To delete an external exchange rate, follow these steps:&#x20;

1. Locate the external exchange rate you wish to delete.&#x20;
2. Click the "Delete" icon. <br>

   <figure><img src="https://1412218885-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjte3ihj30mTFvqCasyX%2Fuploads%2F7MYL0ytrmtsQt2g3qVnj%2Fimage.png?alt=media&#x26;token=c7cb267b-2c0a-4730-aed2-6adf036d22c9" alt=""><figcaption></figcaption></figure>
3. A popup notice will appear for you to confirm your action. Click "Confirm" to proceed. <br>

   <figure><img src="https://1412218885-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjte3ihj30mTFvqCasyX%2Fuploads%2FAM2o7QefHiMtpRGWYBkZ%2Fimage.png?alt=media&#x26;token=b986b3ba-3594-4c7f-92fd-5da852191ba5" alt=""><figcaption></figcaption></figure>
4. You will not be able to delete the external exchange rate if it is currently being used.&#x20;

</details>

### <mark style="color:red;">External Exchange Rates API Documentation</mark>&#x20;

You will be able to view the full API documentation for External Exchange Rates by clicking onto "LEARN MORE".&#x20;

<figure><img src="https://1412218885-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjte3ihj30mTFvqCasyX%2Fuploads%2FjDJoM0x9Fff8A8sL9FSK%2Fimage.png?alt=media&#x26;token=895603ac-e18f-45af-965a-0dcf6ec7dabd" alt=""><figcaption></figcaption></figure>

### <mark style="color:red;">Assigning External Exchange Rate to Payment Method</mark>

To assign your external exchange rate to a payment method, follow these steps:

{% tabs %}
{% tab title="Step 1" %}

1. Navigate to Transaction Settings > Deposit Settings.&#x20;
2. Locate the payment method you wish to assign the external exchange rate to and click the "Edit" icon. <br>

   <figure><img src="https://1412218885-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjte3ihj30mTFvqCasyX%2Fuploads%2FrN1qY3si0EXyyHQYYgss%2Fimage.png?alt=media&#x26;token=797cd8a6-9603-480d-a97d-d594e667766f" alt=""><figcaption></figcaption></figure>

{% endtab %}

{% tab title="Step 2" %}

1. Click "Use external exchange rate".&#x20;
2. Select your external exchange rate source.&#x20;
3. Click " Save". <br>

   <figure><img src="https://1412218885-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjte3ihj30mTFvqCasyX%2Fuploads%2FZTjcf7TCm30V6pkhST1C%2Fimage.png?alt=media&#x26;token=b4f1938c-fc91-437a-8109-59722e8a62af" alt=""><figcaption></figcaption></figure>

{% endtab %}

{% tab title="Step 3" %}
When your client deposit funds, the respective exchange rate from your source will be applied.&#x20;

<figure><img src="https://1412218885-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZjte3ihj30mTFvqCasyX%2Fuploads%2FDbeVJE1vEM11bi8QXZyE%2Fimage.png?alt=media&#x26;token=aabc578c-abb2-4ace-90aa-03548c28e3e9" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}
