How to integrate LuqaPay
Learn how to set up LuqaPay integration with B2CORE via PSS to enable withdrawals
LuqaPay can be connected to B2CORE through PSS, supporting withdrawals via bank transfers in TRY.
Follow the instructions below to configure the LuqaPay connection and set up the withdrawal method in the B2CORE Back Office. These instructions correspond to the General procedure for adding methods for PSS-supported payment systems, but include details specific to LuqaPay.
Configure a connection to LuqaPay
To configure a connection to LuqaPay for making withdrawals:
In the B2CORE Back Office, navigate to System > External connections.
Click +Create in the upper-right page corner.
On the Create connection page, fill in the following fields:
In the Name field, enter a name for the connection. The name must be unique and may only contain Latin letters, numbers, dashes, and underscores (for example,
Withdrawals_LuqaPay).In the Caption field, enter a caption that will be applied to the connection in the Back Office.
In the Provider dropdown, select PaymentSystemWithdrawal.
In the Driver dropdown that appears, select LuqaPay.
In the Credentials section that appears, configure the LuqaPay-specific settings:
In the API base URL field, specify:
https://wallet.luqapay.com— for the production environmenthttps://sandbox-wallet.luqapay.com— for the sandbox testing environment
In the API key field, enter the API key generated in your LuqaPay account.
In the API secret key field, enter the API secret generated in your LuqaPay account.
Click Save to create the connection.
The LuqaPay connection will appear in the list of external connections.
Check the connection status.
If the connection is inactive (No is displayed in the Enabled column), click the Edit button to open the connection details and set the Enabled dropdown to Yes.
Click Save to apply the changes.
Add a withdrawal method through LuqaPay
To add and set up a method for making withdrawals through LuqaPay:
In the B2CORE Back Office, navigate to System > Payout system > Payout methods.
Click +Create in the upper-right page corner.
On the Create a payout method page, fill in the following fields:
In the Name field, enter a name for the method. The name must be unique and may only contain Latin letters, numbers, dashes, and underscores.
In the Caption field, enter a caption for the method. This caption will be assigned to the method in the Back Office and will be visible to clients in the B2CORE UI.
In the Provider dropdown, select PaymentSystemWithdrawal.
After selecting PaymentSystemWithdrawal, the following fields appear:
In the Available account currencies dropdown, select one or more currencies. Withdrawals through LuqaPay will be available from accounts denominated in the selected currencies.
In the Driver dropdown, select LuqaPay.
In the Connection dropdown, select the previously configured LuqaPay connection.
In the Configuration section, select Türkiye in the Country dropdown. This is the only supported country for this integration.
Click Save to create the withdrawal method.
The LuqaPay withdrawal method will appear in the list of withdrawal methods.
Click Edit to enter the method details and complete the following fields:
On the Settings tab, use the Group dropdown to select one or more groups where the method should be included.
In the Icon field, specify the URL of an image that will be displayed as the icon for the withdrawal method in the B2CORE UI.
Check the method status.
If the method is inactive (No is displayed in the Enabled field), activate it by setting the Enabled dropdown to Yes.
On the PS Currencies tab, add
TRY. This is the only currency supported for processing withdrawals with this integration.If needed, configure commissions for the method on the Commissions tab (for details, refer to How to configure commissions for deposit and withdrawal methods).
Click Save to apply the changes.
The LuqaPay withdrawal method is now configured in the B2CORE Back Office.
Set up a webhook in LuqaPay
To receive status updates for withdrawals in B2CORE, a notification webhook must be set up on the side of LuqaPay.
Copy the webhook URL from the B2CORE Back Office
In the B2CORE Back Office, navigate to System > Payout system > Payout methods.
Find the configured LuqaPay withdrawal method and click Edit to open the method details.
Go to the Webhooks tab.
Copy the URL displayed in the Notification URL field.
Provide the webhook URL to LuqaPay
Send the copied webhook URL to the LuqaPay support for configuration on their side.
Last updated
Was this helpful?