V7.40.0 - LuqaPay Integration
Learn about all the details of all our recent CRM updates here.
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.
Currently, only the Japan Community Bank Transfer method is supported.
Key Function Highlights
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.
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.
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.
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.
1) Marketplace Installation & Permission Settings
To begin using LuqaPay, you’ll first need to install it from the CRM Marketplace. Follow the steps below to complete the installation:
Enable Permissions
After installation, you must assign the appropriate permissions to users who will manage LuqaPay settings. These include:
Read LuqaPay Settings – Allows view-only access.
Create LuqaPay Settings – Grants permission to create new LuqaPay configurations.
Update LuqaPay Settings – Allows updates to existing LuqaPay settings.
Delete LuqaPay Settings – Grants the ability to remove LuqaPay configurations.

2) Security Checklist
After installation and permission setup, you will find LuqaPay Settings under PSP Settings in your CRM.

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.

3) Create LuqaPay Settings
To create LuqaPay settings, follow these steps:
Configure LuqaPay Settings
Fill in the respective fields and click "Save".
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".
Deposit Matching Buffer (+/-):
Fill in positive integers only.
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.

4) View, Edit & Delete LuqaPay Settings
You will be able to perform the following actions on your LuqaPay Settings:
5) Create LuqaPay Deposit Method
To setup LuqaPay as a deposit method, follow these steps:
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.
Navigate to Transaction Settings > Payment Gateway Icon.
Click "Create".
Enter the name for the icon.
Upload an image for the icon. Make sure it is 200x200 pixels, has a transparent background, and is in PNG format.
Click "Save".
Create Payment Method
Navigate to Transaction Settings > Deposit Settings.
Under "Payment Method Settings", click "Create".
Fill in the details:
Select Platform: Choose LuqaPay – Japan Community Bank Transfer
Select Icon: Choose the LuqaPay icon
Select Clients or Client Groups: Specify which clients or groups this deposit method applies to.
Method: Enter the name of the payment method.
Supported Currencies: Currently, only JPY is available
Fill in these values as required: Decimals, Minimum Deposit, Maximum Deposit, Fee, and Maximum Fee.
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.
Show Trading Amount: Checked by default; this will display both the payment amount and the actual deposited amount for the client’s reference.
The deposit fields shown are mandatory and required by LuqaPay.
You can add custom deposit fields if needed by clicking the "Create" icon.
Click Save to save your payment method configuration.
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:
Go to "Exchange Rates".
Locate "JPY" in the currency list and click the "Edit" icon.
Assign Client Groups
Select the client groups this exchange rate should apply to.
You can set different exchange rates for different client groups by clicking "Add Exchange Rate".
Setting the client group as "Other Client Groups" means any groups not explicitly configured will follow this rate.
Configure the Type:
Manual: Enter the exchange rate manually.
Auto Update:
Choose your preferred exchange rate source.
Enter a markup % if you wish to apply one.
Display Exchange Rate (optional):
Check this option if you want clients to view the current exchange rate in their portal.
Click "Save" to apply your settings.
6) Create LuqaPay Withdrawal Method
To setup LuqaPay as a withdrawal method, follow these steps:
Configure Withdrawal Method Settings
Fill in the details:
Select Platform: Choose LuqaPay – Japan Community Bank Transfer
Method Name: Enter the name of the withdrawal method.
Select Clients or Client Groups: Specify which clients or groups this withdrawal method applies to.
Supported Currencies: Currently, only JPY is available
Fill in these values as required: Minimal Withdrawal, Maximum Withdrawal, Fee and Maximum Fee.
The withdrawal fields shown are mandatory and required by LuqaPay.
You can add custom withdrawal fields if needed by clicking the "Create" icon.
Click Save to save your withdrawal method configuration.
7) Client Deposit via LuqaPay
To deposit funds via LuqaPay, your clients can follow these steps:
Fill in Deposit Form
Select "LuqaPay" as the payment method.
Currency: “JPY” will be selected by default, as it is the only supported currency.
Choose the Account to which the funds will be deposited.
Select the Bank: A dropdown list will display all banks supported under LuqaPay – Japan Community Bank Transfer.
Enter the "Preferred Payment Amount".
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.
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.
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.
Click “Deposit” to proceed.
A confirmation popup will appear for the client to review payment details. Click “Pay Now” to submit the request.
After confirming, the client will be redirected to the bank payment page to complete the payment.
Review Deposit Request
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.
Navigate to CRM Back Office > Approval > Deposit.
Click "Review" on the deposit request you wish to assess.
The Payment Status will initially appear as "Pending".
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.
Any action taken—whether refreshing or editing—will be recorded in the log section below for audit purposes.
If the client has successfully completed the payment and LuqaPay reflects a "Success" status, this status will be updated in the CRM.
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.
You can then proceed to Approve or Reject the deposit request.
If your Approval Settings for deposit requests are configured to Automatic, the system will automatically approve the request upon receiving a “Success” callback.
8) Client Withdraw via LuqaPay
To withdraw funds via LuqaPay, your clients can follow these steps:
Fill in Withdrawal Form
Select the account you wish to withdraw from.
Enter the withdrawal amount.
Choose "LuqaPay" as your withdrawal method.
Select the withdrawal currency. Currently, only JPY is supported.
Choose your bank and fill in the required details.
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.
Click “Submit” to complete the request.
Review Withdrawal Request
Navigate to CRM Back Office > Approval > Withdrawal.
Click "Review" on the withdrawal request you wish to assess.
Review the request and click "Reject" or "Approve".
Upon first-level approval:
Funds will be deducted from the client's account, and the CRM Balance Status will be updated to "Deducted".
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".
Upon Second-Level Approval:
If the “Payout” action is set to trigger at the second level instead, the withdrawal request will be sent to LuqaPay at this stage.
The payment status will be updated to "Pending."
If the withdrawal is successfully matched with a deposit request from another client, the payment status will be updated to "Success."
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.
The CRM balance status will then be updated to "Refunded." The status of the request will also be updated to "Cancelled".
Last updated