# V7.40.0 - LuqaPay Integration

**Released Date - 4 April 2025**

We’re pleased to announce the integration of LuqaPay with your CRM—a peer-to-peer payment solution built to simplify and modernize fund transfers. Designed for speed, flexibility, and transparency, LuqaPay connects your traders to a wider community network, allowing deposits and withdrawals to be automatically matched across the ecosystem—not just within your client base.

With this integration, you can offer your clients a streamlined alternative to traditional banking channels, while maintaining full visibility and control over transaction flows. Real-time balance tracking and automated fund reconciliation are available directly via the LuqaPay platform, ensuring operational efficiency at every step.

{% hint style="warning" %}
Currently, only the Japan Community Bank Transfer method is supported.
{% endhint %}

### <mark style="color:red;">**Key Function Highlights**</mark>

1. **Peer-to-Peer Matching System:** Tap into the full LuqaPay network to automatically pair deposit and withdrawal requests across the ecosystem. Rather than limiting matches to clients within the same broker, LuqaPay’s shared pool enables faster and more efficient fund movement—minimizing manual oversight and boosting transaction success rates.
2. **Localized Payment Method:** Tailored for the Japanese market, LuqaPay's Community Bank Transfer method offers a familiar and trusted payment route for local traders. It simplifies fund transfers, aligning with domestic banking practices and enhancing user confidence in the process.
3. **Real-Time Deposit & Withdrawal Matching:** Through the CRM Client Portal, traders can instantly view available withdrawal requests that match their intended deposit amounts. This feature speeds up the funding process, reduces wait times, and helps prevent unmatched transactions—resulting in a smoother, more efficient user experience.
4. **Automatic Withdrawal Timeout and Refunds:** If a withdrawal request remains unmatched for 72 hours, it is automatically canceled and refunded to the client. This safeguard ensures timely fund returns, prevents unnecessary delays, and reinforces the reliability of the LuqaPay system.

### <mark style="color:red;">1)   Marketplace Installation & Permission Settings</mark>

To begin using LuqaPay, you’ll first need to install it from the CRM Marketplace. Follow the steps below to complete the installation:

{% stepper %}
{% step %}

#### Access the CRM Marketplace

1. Log in to your CRM back office portal.
2. Navigate to the CRM Marketplace.<br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2F3j27dzP6gY4IribyrNAH%2Fimage.png?alt=media&#x26;token=13584083-c776-441c-b339-2d757b9bf996" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

#### Install LuqaPay

1. Locate LuqaPay and click onto it. <br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FoHY6rKX1At8IVvyRCfnt%2Fimage.png?alt=media&#x26;token=f04ea342-ae3e-475a-aef0-db1438be3643" alt=""><figcaption></figcaption></figure>
2. You will be redirected to the details page.&#x20;
3. Click "Install" to begin the installation process. <br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FtZU5Kj0zTdHTt0tLdJ4s%2Fimage.png?alt=media&#x26;token=1fe43be7-c97d-4995-aca1-5c79ef818f3a" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

#### Enable Permissions

After installation, you must assign the appropriate permissions to users who will manage LuqaPay settings. These include:

1. **Read LuqaPay Settings** – Allows view-only access.
2. **Create LuqaPay Settings** – Grants permission to create new LuqaPay configurations.
3. **Update LuqaPay Settings** – Allows updates to existing LuqaPay settings.
4. **Delete LuqaPay Settings** – Grants the ability to remove LuqaPay configurations.

<figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2Fs3VA6sEVnCTY3YrQsifd%2Fimage.png?alt=media&#x26;token=a4f8f47b-533b-4c30-82ea-f45f89191ebc" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### <mark style="color:red;">2)   Security Checklist</mark>

After installation and permission setup, you will find LuqaPay Settings under PSP Settings in your CRM.&#x20;

<figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2Fug61rDT0uzKzNsUTiKmE%2Fimage.png?alt=media&#x26;token=de39d3f8-9757-4d43-a2dd-e0b8b2a77505" alt=""><figcaption></figcaption></figure>

This section includes a **Security Checklist** that outlines recommended security enhancements—particularly useful for online deposit and withdrawal workflows. While optional, completing these steps is strongly advised to strengthen your overall platform security.

The system will automatically detect and mark each requirement as completed once the relevant configuration is in place.

<figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2Fn0ZtTUcEdlOYP4sNG5zO%2Fimage.png?alt=media&#x26;token=3dd70752-d052-4089-bcbd-fd3b6d0253c7" alt=""><figcaption></figcaption></figure>

<details>

<summary>Mandatory 2FA Verification</summary>

Mandatory two-factor authentication (2FA) helps prevent unauthorized access to your CRM. To setup, follow these steps:

1. Click "Go Now" to be redirected to Settings > Client Portal Settings > Security Settings. <br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2Foiy03UC6k9FZT8aGKS4t%2Fimage.png?alt=media&#x26;token=8961b0f6-63e0-49b3-bc0f-b78fcf690116" alt=""><figcaption></figcaption></figure>
2. Click the "Edit" icon. <br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FKQHPR7k3TdeHZjP2lJn7%2Fimage.png?alt=media&#x26;token=3f724643-68ac-4d0c-8655-b2f8ed3b6032" alt=""><figcaption></figcaption></figure>
3. Enable Mandatory 2FA.&#x20;
4. You may select which application scenarios should require 2FA.
5. Note: "Login" is mandatory and cannot be disabled.
6. Click "Save". <br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FwEwXsClQAwAAYju0LXDv%2Fimage.png?alt=media&#x26;token=04014e29-64c1-4642-a478-6611a4ed7731" alt=""><figcaption></figcaption></figure>
7. Once mandatory 2FA is enabled, this step will be automatically marked as complete in the checklist.<br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2Fz7JpZqMPATJsAkPwOBFg%2Fimage.png?alt=media&#x26;token=e57ad3f3-72ab-40fc-9a32-8f914c0c6b3c" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Multi-Level Approval Installation</summary>

This adds an extra layer of verification for sensitive actions like withdrawals. To install Multi-Level Approval, follow these steps:

1. Click "Go Now" to be redirected to the CRM Marketplace.<br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FlHDrAArrPc1D30ahCiSD%2Fimage.png?alt=media&#x26;token=046d5e5a-7a9e-4263-9c92-d2e3f22afea8" alt=""><figcaption></figcaption></figure>
2. Search for "Multi-Level Approval" and click on the listing. <br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FTXjQOofvB0qjjgQQBFyB%2Fimage.png?alt=media&#x26;token=05cfae45-2ea6-4b55-9e23-b6d69a1eaceb" alt=""><figcaption></figcaption></figure>
3. You will be redirected to the details page.&#x20;
4. Click "Install" to proceed. <br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FsN20NFGp8LgvemRdFlRe%2Fimage.png?alt=media&#x26;token=4ecd0407-7dad-4915-8a01-283cc7e17739" alt=""><figcaption></figcaption></figure>
5. Once installed, the checklist item will be marked as completed.<br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FAJJXg68yFAM7FvU9I5kG%2Fimage.png?alt=media&#x26;token=79ea4b45-ee81-49c6-bd95-a193bb22cae7" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Setup Multi-Step Approval for Withdrawals</summary>

This ensures withdrawal requests go through at least two levels of verification. To setup, follow these steps:

1. Click "Go Now" to be redirected to Settings > Approval Settings > Process Settings. <br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FWrz6GZeL1mc7IEEYWjBO%2Fimage.png?alt=media&#x26;token=a9a325cc-58fe-40fa-9e8c-44b373ae90c6" alt=""><figcaption></figcaption></figure>
2. Locate the Withdrawal process and click the "Edit" icon. <br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2Ffg7GAHfziL0phmwTASw5%2Fimage.png?alt=media&#x26;token=9800b05f-ad19-4822-a2ea-bc3ec47bcf58" alt=""><figcaption></figcaption></figure>
3. Click the "+" icon to add a new level.<br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FrHBBDUHCDXb6E4aWcqBG%2Fimage.png?alt=media&#x26;token=6155ee6b-7156-47a2-80d9-49f50a2e8179" alt=""><figcaption></figcaption></figure>
4. Select "No approver" and assign the responsible party for each level. \
   \
   ![](https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FvBLc0EjhB2TQxmWny5nL%2Fimage.png?alt=media\&token=6909f873-eb10-4b5f-8a1a-9e8f9edfbbbf)<br>
5. You can assign either individual users or roles. \
   \
   ![](https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FHyqylgbabjCuv3Tl2WNl%2Fimage.png?alt=media\&token=ab61485b-2ac2-4033-886e-48de5d70c8f8)<br>
6. Click "Confirm". \
   \
   ![](https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FjXtG23AkiKmA3tdqSvry%2Fimage.png?alt=media\&token=130f073a-7f82-4778-abfd-06ee0489ef83)<br>
7. It is recommended to have at least 2 levels of approvers:
   * First Level: Deduct Level of Approval. Upon approval, the withdrawal amount will be deducted from the trading account or wallet.
   * Second Level: Payout Level of Approval. Upon approval, the withdrawal request will be sent to LuqaPay and the funds will be paid out to your client.
8. Upon adding the second level of approver, the first level will automatically be assigned both the "Deduct" and "Payout" approval. To set the second level as the "Payout", click the "Payout" icon. \
   \
   ![](https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FVJyWE8OWbbBJj1j4B9t6%2Fimage.png?alt=media\&token=26fc83d2-8098-4c81-bb9b-c672acaf283a)<br>
9. For the first level, you can choose between manual or automatic approval. It is recommended to select manual approval so you can review the withdrawal request and its details before processing. To setup:&#x20;
   1. Click on the "Settings" icon. \
      \
      ![](https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FIv2uEtbK1UnzReKCfJYO%2Fimage.png?alt=media\&token=bee032eb-b98c-4d1e-bf9c-3ec7994101e4)<br>
   2. Select "Manual" and click "Confirm". \
      \
      ![](https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2F3jsePwAZMsTQjYbPYgMr%2Fimage.png?alt=media\&token=48e4415f-cf28-4a08-be58-ff0054b8d9ef)<br>
10. Click "Publish" to save your changes. <br>

    <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FWKA8Xk115vzdVkEHgxgb%2Fimage.png?alt=media&#x26;token=6f34d16e-92d5-4835-b7c1-618a346c7651" alt=""><figcaption></figcaption></figure>
11. After publishing, this checklist item will be marked as completed.<br>

    <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FfodXv2q9ygQSNi9MYcdJ%2Fimage.png?alt=media&#x26;token=df45f9e7-a07c-4651-b018-2f27ea9430e2" alt=""><figcaption></figcaption></figure>

</details>

### <mark style="color:red;">3)   Create LuqaPay Settings</mark>

To create LuqaPay settings, follow these steps:

{% stepper %}
{% step %}

#### Retrieve Details from LuqaPay

1. Login to your LuqaPay account.&#x20;
2. Navigate to "Accounts".&#x20;
3. Retrieve your "API Key" and "Secret Key".<br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2F65rpVUhbpo5zcqiRVuXJ%2Fimage.png?alt=media&#x26;token=8460e7b9-fa25-48e3-946e-4653cfc0aecc" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

#### Create LuqaPay Settings on CRM

1. Navigate to Settings > PSP Settings > LuqaPay Settings.&#x20;
2. Click "Create". <br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FeqEYaHdHn7dnrrvOse2S%2Fimage.png?alt=media&#x26;token=e26b2425-60cf-4cd3-bb1b-b28c0d47c2a8" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

#### Configure LuqaPay Settings

Fill in the respective fields and click "Save".&#x20;

* Name
* API Key — retrieved from the LuqaPay portal
* Secret Key — retrieved from the LuqaPay portal
* Select Environment: Sandbox or Production
* Payment Method: The only available option is "Community Bank Transfer".&#x20;
* Deposit Matching Buffer (+/-):&#x20;
  * Fill in positive integers only.&#x20;
  * Defines the range around the deposit amount that your clients can choose from when making a deposit via LuqaPay.
  * For example, if your client wants to deposit $1,000 and the Deposit Matching Buffer is set to $100, the available deposit options will range from $900 to $1,100.<br>

<figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2Fw5jg1mIsT5o6X58UvyyL%2Fimage.png?alt=media&#x26;token=61ce8f73-384c-4f17-b877-feedab6f5151" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### <mark style="color:red;">4)   View, Edit & Delete LuqaPay Settings</mark>

You will be able to perform the following actions on your LuqaPay Settings:

<details>

<summary>View Settings</summary>

To view LuqaPay settings, follow these steps:

1. Locate the specific LuqaPay setting you wish to view.
2. Click on the "View" icon.<br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FAwXKDwxNjmyJeKkdltEU%2Fimage.png?alt=media&#x26;token=e7a0729e-3d76-4f13-af90-66dfa28ff5c0" alt=""><figcaption></figcaption></figure>
3. You will be able to see all the configured settings.

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FJnarnOM2ZSMtmiWZFwf7%2Fimage.png?alt=media&#x26;token=6c7a485b-4e54-4956-84d0-9b6902452492" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Edit Settings</summary>

To edit LuqaPay settings, follow these steps:

1. Locate the LuqaPay settings you want to edit.
2. Click on the "Edit" icon.<br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2Fx3p0xDP5TRkNWxfQR7oG%2Fimage.png?alt=media&#x26;token=8d1c143a-33fb-42e7-b444-434bd85583d6" alt=""><figcaption></figcaption></figure>
3. Make the necessary amendments.
4. Click on "Save" to save the updated settings.<br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FAaQnzL0O5QsKscFegGrR%2Fimage.png?alt=media&#x26;token=fa0a3ce3-ef2b-4513-8753-2f9386090d42" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Delete Settings</summary>

To delete LuqaPay settings, follow these steps:

1. Locate the LuqaPay settings you want to delete.
2. Click on the "Delete" icon.<br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FGdRXTze8TLjutONsSnN6%2Fimage.png?alt=media&#x26;token=c7cc9365-98df-4c6f-807b-d9763851ea4a" alt=""><figcaption></figcaption></figure>
3. A confirmation popup notice will appear.
4. Click "Confirm" to proceed with the deletion.\
   \
   ![](https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2F1BUyVm5utnieZbYn9zZv%2Fimage.png?alt=media\&token=5a23c232-29fc-4c8c-9c4a-ebb1168af6bc)<br>
5. Please note that if the LuqaPay setting is being used by an existing deposit method, you will not be able to delete it.

</details>

### <mark style="color:red;">5)   Create LuqaPay Deposit Method</mark>

To setup LuqaPay as a deposit method, follow these steps:

{% stepper %}
{% step %}

#### Create LuqaPay Icon

Creating this icon allows you to assign it to your deposit method, helping your clients easily identify LuqaPay among other deposit options.&#x20;

1. Navigate to Transaction Settings > Payment Gateway Icon.&#x20;
2. Click "Create". <br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2Fq13ywD6rwxjiK04FkPbc%2Fimage.png?alt=media&#x26;token=b9a59353-0603-4671-953b-ccd4ac90e9f5" alt=""><figcaption></figcaption></figure>
3. Enter the name for the icon.
4. Upload an image for the icon. Make sure it is 200x200 pixels, has a transparent background, and is in PNG format.
5. Click "Save". <br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FbctmBhZbpV4n8CgS3DcO%2Fimage.png?alt=media&#x26;token=267fa08b-0e11-4364-94ba-658371b5c696" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

#### Create Payment Method

1. Navigate to Transaction Settings > Deposit Settings.&#x20;
2. Under "Payment Method Settings", click "Create".\
   &#x20;

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FILdTiNqu6ODELiaI4MM0%2Fimage.png?alt=media&#x26;token=61c3ee2d-3711-49c9-a515-f87782ba3856" alt=""><figcaption></figcaption></figure>
3. Fill in the details:&#x20;
   1. Select **Platform**: Choose LuqaPay – Japan Community Bank Transfer
   2. Select **Icon**: Choose the LuqaPay icon
   3. Select **Clients or Client Groups**: Specify which clients or groups this deposit method applies to.
   4. **Method**: Enter the name of the payment method.
   5. **Supported Currencies**: Currently, only JPY is available
   6. Fill in these values as required: **Decimals, Minimum Deposit, Maximum Deposit, Fee, and Maximum Fee**. <br>

      <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FAgZkji2XFMNsC1pJTLyU%2Fimage.png?alt=media&#x26;token=c049ddc9-fc92-4e55-aa03-ee1c38dbb6ea" alt=""><figcaption></figcaption></figure>
4. **Use External Exchange Rate**: Check this if you want to use your own exchange rate source for converting JPY to the client’s account currency.
5. **Show Trading Amount**: Checked by default; this will display both the payment amount and the actual deposited amount for the client’s reference.
6. The deposit fields shown are mandatory and required by LuqaPay.
7. You can add custom deposit fields if needed by clicking the "Create" icon.
8. Click Save to save your payment method configuration.<br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2F521EEKUDRVa9VRb4fe4A%2Fimage.png?alt=media&#x26;token=e9c22e51-12d7-46e8-87ac-54614bb7c605" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

#### **Ensure Exchange Rate is Set**

If you did not enable the **"Use External Exchange Rate"** option when creating the LuqaPay payment method, you must manually configure the exchange rate for **JPY**.

To set the exchange rate:

1. Go to "Exchange Rates".&#x20;
2. Locate "JPY" in the currency list and click the "Edit" icon.<br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FQYdsE7WjzaTQPEF20nKz%2Fimage.png?alt=media&#x26;token=52bb72fa-4197-45fb-874b-5da37cf10654" alt=""><figcaption></figcaption></figure>
3. Assign Client Groups
   1. Select the client groups this exchange rate should apply to.
   2. You can set different exchange rates for different client groups by clicking "Add Exchange Rate".
   3. Setting the client group as "Other Client Groups" means any groups not explicitly configured will follow this rate.<br>

      <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FfbYY8gefrpG9jPDfJtso%2Fimage.png?alt=media&#x26;token=bad7502b-7e26-48db-ab74-fd8add6b6d3e" alt=""><figcaption></figcaption></figure>
4. Configure the Type:
   * Manual: Enter the exchange rate manually.<br>

     <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FBLwmoCjcIOiMqANQq4Ri%2Fimage.png?alt=media&#x26;token=16336162-7d31-4772-8e50-297dd011fb99" alt=""><figcaption></figcaption></figure>
   * Auto Update:
     * Choose your preferred exchange rate source.
     * Enter a markup % if you wish to apply one.
5. Display Exchange Rate (optional):
   * Check this option if you want clients to view the current exchange rate in their portal.
6. Click "Save" to apply your settings.<br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2Fd9v5J72b1NwWhMPu0R1O%2Fimage.png?alt=media&#x26;token=286a1bf1-0706-4c27-8af0-13455c5a083b" alt=""><figcaption></figcaption></figure>

{% endstep %}
{% endstepper %}

### <mark style="color:red;">6)   Create LuqaPay Withdrawal Method</mark>

To setup LuqaPay as a withdrawal method, follow these steps:

{% stepper %}
{% step %}

#### Create Withdrawal Method

1. Navigate to Transaction Settings > Withdrawal Settings.&#x20;
2. Scroll down to "Withdrawal Method Settings".&#x20;
3. Click "Create". <br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FYxTb5ql6R2bLHBI8VffL%2Fimage.png?alt=media&#x26;token=804bbeab-74b1-4e24-8c81-7b38ed50a8bf" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

#### Configure Withdrawal Method Settings

Fill in the details:&#x20;

1. Select **Platform**: Choose LuqaPay – Japan Community Bank Transfer
2. **Method Name**: Enter the name of the withdrawal method.
3. Select **Clients or Client Groups**: Specify which clients or groups this withdrawal method applies to.
4. **Supported Currencies**: Currently, only JPY is available
5. Fill in these values as required: **Minimal Withdrawal, Maximum Withdrawal, Fee and Maximum Fee.** <br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FMRIprxNdDvaCYjHirO5Y%2Fimage.png?alt=media&#x26;token=8d2f1a4a-83a2-4eea-b8f4-cab3c4371918" alt=""><figcaption></figcaption></figure>
6. The withdrawal fields shown are mandatory and required by LuqaPay.
7. You can add custom withdrawal fields if needed by clicking the "Create" icon.
8. Click Save to save your withdrawal method configuration.\
   \
   ![](https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FG8spl6ExHSVyhstHDMnU%2Fimage.png?alt=media\&token=1696fcdf-1537-4e6b-8afe-5264b50fb0f0)<br>
   {% endstep %}

{% step %}

#### **Ensure Exchange Rate is Set**

Similarly, ensure that the exchange rate for JPY is configured. Follow the same steps as outlined for payment method.
{% endstep %}
{% endstepper %}

### <mark style="color:red;">7)   Client Deposit via LuqaPay</mark>

To deposit funds via LuqaPay, your clients can follow these steps:

{% stepper %}
{% step %}

#### Deposit Funds

1. Login to CRM Client Portal.&#x20;
2. Navigate to Funds.&#x20;
3. Click "Deposit". <br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FO6PlwzjYPz2ub31HjNr0%2Fimage.png?alt=media&#x26;token=97dc132a-db51-45e3-a9c1-c4f532802fd6" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

#### Fill in Deposit Form

1. Select "LuqaPay" as the payment method.&#x20;
2. **Currency**: “JPY” will be selected by default, as it is the only supported currency.
3. Choose the **Account** to which the funds will be deposited.
4. **Select the Bank**: A dropdown list will display all banks supported under LuqaPay – Japan Community Bank Transfer.
5. Enter the **"Preferred Payment Amount"**.
6. The system will automatically generate a list of available **Payment Amounts**, based on the Deposit Matching Buffer you’ve configured.
   * If available options are found, your client can click **“Payment Amount”** to view a dropdown menu of matched values and select their preferred one.<br>

     <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FFcjJ6BkfYu3WIBj8zTUp%2Fimage.png?alt=media&#x26;token=a155f7ee-2f9f-4bd3-9b51-d0e7918a27f1" alt=""><figcaption></figcaption></figure>
   * If no matches are found, the **“Payment Amount”** field will be disabled. The client can revise their preferred payment amount to try and find a match.<br>

     <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FAKUnxuKP3fRemNoVgAda%2Fimage.png?alt=media&#x26;token=dbf502c8-299d-496b-95cb-e2284296d647" alt=""><figcaption></figcaption></figure>
7. Complete the required fields:

   * **Country**: Only “Japan” is available
   * **First Name**
   * **Last Name**
   * **Email**
   * **Date of Birth**
   * If your client’s KYC has been approved and these fields (Email and Date of Birth) are part of your KYC fields (CRM Default Fields), the information will be automatically populated. However, clients can still edit the details if necessary.<br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2F6nGrtNfp6pIAJMmLjage%2Fimage.png?alt=media&#x26;token=08f520d3-1ef7-4364-8d58-de1fd0180ed5" alt=""><figcaption></figcaption></figure>
8. Click “Deposit” to proceed.
9. A confirmation popup will appear for the client to review payment details. Click “Pay Now” to submit the request.\
   \
   ![](https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2Fjuzk8y7LVj7CS3wMtSXw%2Fimage.png?alt=media\&token=76a6723b-f3bd-4326-b953-cc126c938482)<br>
10. After confirming, the client will be redirected to the bank payment page to complete the payment.\
    \
    ![](https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FUeEb1T7dND6yiZZUu5tf%2Fimage.png?alt=media\&token=521d6806-e0f5-4d91-8441-343eab0dacb6)<br>
    {% endstep %}

{% step %}

#### Review Deposit Request

1. Once your client is redirected to the bank page to complete the payment, a deposit request will be generated in the CRM—regardless of whether the client has completed the payment.
2. Navigate to CRM Back Office > Approval > Deposit.
3. Click "Review" on the deposit request you wish to assess.<br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FHN28l6JcVWTDETsvw1Kb%2Fimage.png?alt=media&#x26;token=87327dc9-2fe3-48d2-8eac-43edd9c7ac29" alt=""><figcaption></figcaption></figure>
4. The Payment Status will initially appear as "Pending".\
   \
   ![](https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FXwy47JHKoofNghh57i3a%2Fimage.png?alt=media\&token=f04b962f-bf1c-4a7d-bfe6-117c2681728b)<br>
5. You can refresh the payment status by clicking the “Refresh” icon. If needed, you may also manually update the payment status by clicking the “Edit” icon.<br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2F8Ec8FBufiHo7bG6fBXb2%2Fimage.png?alt=media&#x26;token=74fa942b-09da-4070-b281-7ae9b58fc7cf" alt=""><figcaption></figcaption></figure>
6. Any action taken—whether refreshing or editing—will be recorded in the log section below for audit purposes.<br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FWd9tyl1fNaeG2mhyCP8M%2Fimage.png?alt=media&#x26;token=e84b42a6-3917-4a70-8ccb-85eda4ce87f1" alt=""><figcaption></figcaption></figure>
7. If the client has successfully completed the payment and LuqaPay reflects a **"Success"** status, this status will be updated in the CRM.<br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2Fqn8e19ngM59lGGT9X88b%2Fimage.png?alt=media&#x26;token=54369a00-d964-4c58-9ea3-6a496f0fc2a7" alt=""><figcaption></figcaption></figure>
8. Note: LuqaPay's IPN callback may return multiple statuses. The CRM will only update the payment status to “Success” if the callback explicitly indicates a “Success” status.
9. You can then proceed to Approve or Reject the deposit request.
10. If your Approval Settings for deposit requests are configured to Automatic, the system will automatically approve the request upon receiving a “Success” callback.
    {% endstep %}
    {% endstepper %}

### <mark style="color:red;">8)   Client Withdraw via LuqaPay</mark>

To withdraw funds via LuqaPay, your clients can follow these steps:

{% stepper %}
{% step %}

#### Withdraw Funds

1. Login to CRM Client Portal.&#x20;
2. Navigate to Funds.&#x20;
3. Click "Withdraw". <br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2F855jXATCmUZu8y3G4lmA%2Fimage.png?alt=media&#x26;token=2583b73e-9eca-4025-8fda-9adb180953c6" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

#### Fill in Withdrawal Form

1. Select the account you wish to withdraw from.
2. Enter the withdrawal amount.
3. Choose "LuqaPay" as your withdrawal method.
4. Select the withdrawal currency. Currently, only JPY is supported.<br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2Fw2r2yuoshEvqikqPFTE8%2Fimage.png?alt=media&#x26;token=b6fa3a2f-9e91-47af-9797-bcfb66c6227a" alt=""><figcaption></figcaption></figure>
5. Choose your bank and fill in the required details.<br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2Fi7v93KJcDE6kq9ZQT2R8%2Fimage.png?alt=media&#x26;token=908e7e6d-2f40-4944-a819-d30d8bf796ec" alt=""><figcaption></figcaption></figure>
6. At the bottom of the withdrawal form, your client will be informed that this is a Community Bank Transfer withdrawal request. The request will be listed and matched with another client looking to deposit the same amount. If no match is found within 72 hours, the request will be automatically cancelled and the amount refunded to the account.
7. Click “Submit” to complete the request.<br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FcUahP7G0NRxEbRr3kk5S%2Fimage.png?alt=media&#x26;token=74f518f8-692d-4534-bf0d-ecff213c5dbe" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

#### Review Withdrawal Request

1. Navigate to CRM Back Office > Approval > Withdrawal.
2. Click "Review" on the withdrawal request you wish to assess.<br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FlK0L4v9kDtkdzYHICXTj%2Fimage.png?alt=media&#x26;token=861651b8-e778-4701-8082-d42fc490051b" alt=""><figcaption></figcaption></figure>
3. Review the request and click "Reject" or "Approve". \
   \
   ![](https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2F8Wz4AvuQJ8v8S0X28Umy%2Fimage.png?alt=media\&token=84b4a1c3-c725-4355-aa22-1334608430ab)\ <br>
4. Upon first-level approval:&#x20;
   1. Funds will be deducted from the client's account, and the CRM Balance Status will be updated to "Deducted". <br>

      <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FroRHrbqdjCU1eWMlfVZt%2Fimage.png?alt=media&#x26;token=3aa36be0-4920-4708-811c-bbd1b8604315" alt=""><figcaption></figcaption></figure>

   2. If the "Payout" action is configured to trigger at the first level, the withdrawal request will be sent to LuqaPay for processing. The payment status will be updated to "Pending". <br>

      <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2Fb5l36nMQHCnwhO4QJQMX%2Fimage.png?alt=media&#x26;token=1695bd56-56e8-4ff0-a5bb-e3a3fb1ae1fa" alt=""><figcaption></figcaption></figure>
5. Upon Second-Level Approval:
   1. If the “Payout” action is set to trigger at the second level instead, the withdrawal request will be sent to LuqaPay at this stage.&#x20;
   2. The payment status will be updated to "Pending."
6. If the withdrawal is successfully matched with a deposit request from another client, the payment status will be updated to "Success."<br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FkGQSRoabYLOetz6D56rC%2Fimage.png?alt=media&#x26;token=db8faf65-bc04-41ec-9a3a-cb09514260cd" alt=""><figcaption></figcaption></figure>
7. If no match is found within **72 hours**, the payment status will change to **"Failed,"** and the deducted funds will be automatically **refunded** to the client.
8. The CRM balance status will then be updated to **"Refunded."** The status of the request will also be updated to "Cancelled". <br>

   <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FNRyUT2WAbHElO8DWDuAM%2Fimage.png?alt=media&#x26;token=d5e78497-157e-42f4-85ce-2973c8df7b55" alt=""><figcaption></figcaption></figure>

{% endstep %}
{% endstepper %}
