# V7.13.0 - Smart FX Conversion & New Client Creation API

**Released Date - 27 May 2024**

In this update, we have rolled out a Smart FX conversion capability that allows you to customize your exchange rate sources and easily integrate the rates within your CRM. This new function allows greater flexibility and precision in managing exchange rates for multi-currency transactions. 

Furthermore, we have introduced a new "Client Creation" API. This API enables integration with third-party platforms and allows client accounts to be automatically created in the CRM, using information from the existing platform. This means that external systems such as a lead generation system or KYC system can automatically initiate an account creation process in the CRM, making client onboarding quicker and absolutely seamless. 

Additionally, we've implemented automatic device recognition during PSP transactions to ensure user interface compatibility across all device types, thereby enhancing the security and tracking of all payment transactions. 

## <mark style="color:red;">**Summary**</mark>

1. [**Smart FX Conversion**](#smart-fx-conversion)
   * [**Customized Exchange Rate Sources**](#id-1-customized-exchange-rate-sources): Integrate your preferred exchange rate source directly into the CRM and have greater control and accuracy over your currency conversion rates.
   * [**Customizable FX Symbols**](#id-2-customizable-fx-symbols): Select the source and target symbols even for payment methods that use non-standard international symbols, ensuring accurate currency handling.
2. [**API Enhancements** ](#api-enhancements)
   * [**Client Creation API**](#id-1-client-creation-api): The newly added API allows for the integration of your CRM with external platforms, automating the client creation process and streamlining client onboarding. This enhancement boosts efficiency and connectivity with external systems, enabling the porting of existing client information into the CRM.
   * [**User Device Recognition**](#id-2-user-device-recognition): Automatically recognize your client's device type when a PSP transaction is initiated to ensure every provider returns the appropriate payment page respective to the specific device type, enhancing both user experience and security.

## <mark style="color:red;">Smart FX Conversion</mark>

### <mark style="color:red;">1)   Customized Exchange Rate Sources</mark>

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

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

To begin setting up your 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="/files/Ap6tVEaBmsbpv622Oq8x" alt=""><figcaption></figcaption></figure>

### <mark style="color:red;">B)   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".&#x20;

   <figure><img src="/files/DwCmUdxeswqm7mWfsVKn" 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".&#x20;

   <figure><img src="/files/2eYovykNTWjld0RSxYrH" alt="" width="365"><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.&#x20;

   <figure><img src="/files/H032UBAnkbUokkAqdw7G" alt=""><figcaption></figcaption></figure>
3. The details will be displayed accordingly.&#x20;

   <figure><img src="/files/n8trRKBZtfgIhWS9eDjx" 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.&#x20;

   <figure><img src="/files/5xmtUDCjpuwNZeNojB17" alt=""><figcaption></figcaption></figure>
3. Amend the respective fields.&#x20;
4. Click "Save".&#x20;

   <figure><img src="/files/0UM3KAlYqTT2wqykpCPI" alt="" width="361"><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.&#x20;

   <figure><img src="/files/Q9cTmlGZx1okvgxiamDk" alt=""><figcaption></figcaption></figure>
3. Fill in the Source Account Currency and Target Account Currency.&#x20;
4. Click "Test".&#x20;

   <figure><img src="/files/tY1R4r1YVMJxX3kk40Xu" alt="" width="359"><figcaption></figcaption></figure>
5. If the integration is successful, you will be able to view the exchange rate accordingly.&#x20;

   <figure><img src="/files/9PDvREFsErdLzqLtn0FR" alt="" width="363"><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.&#x20;

   <figure><img src="/files/MmHIfe1l4T1Y8RXS2CNR" alt=""><figcaption></figcaption></figure>
3. A popup notice will appear for you to confirm your action. Click "Confirm" to proceed.&#x20;

   <figure><img src="/files/GKtEIuJ4i9kBu0an9zif" alt="" width="302"><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;">C)    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="/files/bnzlluBJXfXhIRpULE5z" alt=""><figcaption></figcaption></figure>

### <mark style="color:red;">D)   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.&#x20;

   <figure><img src="/files/TnZKfPszLxDyJm8mUSnU" 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".&#x20;

   <figure><img src="/files/HR1UwY6zwXkfh2cooPag" 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="/files/V7Pp8ujp8lq3eOdL2hfu" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### <mark style="color:red;">2)   Customizable FX Symbols</mark>

You can now select the source and target symbols even for payment methods that use non-standard international symbols, ensuring accurate currency handling. This applies to pre-integrated exchange rate providers on the CRM: exchangerate.host and Finrax.

To do so, follow these steps:

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

1. Navigate to Transaction Settings > Deposit or Withdrawal Settings.&#x20;
2. Locate the exchange rate you wish to setup and click "Edit".&#x20;

   <figure><img src="/files/BHxlsX7YrQB3RWpebQt1" alt=""><figcaption></figcaption></figure>

{% endtab %}

{% tab title="Step 2" %}

1. If the currency is not an international standard code, there will be an error in retrieving the exchange rate.&#x20;

   <figure><img src="/files/YIj2umCmX25YHSmSbhyy" alt="" width="563"><figcaption></figcaption></figure>
2. Select the currency manually to retrieve the exchange rate.&#x20;
3. Click "Save".&#x20;

   <figure><img src="/files/15n2Sjr23fMH9KNkneXL" alt="" width="563"><figcaption></figcaption></figure>

{% endtab %}
{% endtabs %}

## <mark style="color:red;">API Enhancements</mark>

### <mark style="color:red;">1)   Client Creation API</mark>&#x20;

We have added a new API for client creation on the CRM. This API allows for the integration of your CRM with external platforms, automating the client creation process and streamlining client onboarding. To access the API documentation, please reach out to your dedicated account manager.&#x20;

### <mark style="color:red;">2)   User Device Recognition</mark>&#x20;

The CRM can now automatically recognize your client's device type when a PSP transaction is initiated to ensure every provider returns the appropriate payment page respective to the specific device type, enhancing both user experience and security.

To do so, follow these steps:&#x20;

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

1. Navigate to PSP Settings.&#x20;
2. Locate the PSP you want to amend and click the "Edit" icon.&#x20;

   <figure><img src="/files/wmcnfGVE13VdvYOwWP4h" alt=""><figcaption></figcaption></figure>

{% endtab %}

{% tab title="Step 2" %}

1. Select "Include device parameters when initiating API calls".&#x20;
2. Click "Save".&#x20;

   <figure><img src="/files/h4nhTeyk0rhq2YiM8FFT" alt="" width="563"><figcaption></figcaption></figure>

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://reference-guide.gitbook.io/crm-version-release-notes/v7.13.0-smart-fx-conversion-and-new-client-creation-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.