> For the complete documentation index, see [llms.txt](https://docs.b2core.b2broker.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.b2core.b2broker.com/how-to-articles/manage-payment-methods/how-to-add-deposit-and-withdrawal-methods-through-pss/how-to-integrate-luqapay.md).
# How to integrate LuqaPay
[LuqaPay](https://luqapay.com/) 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](/how-to-articles/manage-payment-methods/how-to-add-deposit-and-withdrawal-methods-through-pss.md) for adding methods for PSS-supported payment systems, but include details specific to LuqaPay.
{% hint style="info" %}
Before proceeding with the instructions, you must have signed up for LuqaPay and have an active account.
{% endhint %}
## Configure a connection to LuqaPay
To configure a connection to LuqaPay for making withdrawals:
{% stepper %}
{% step %}
In the B2CORE Back Office, navigate to **System** > **External connections**.
{% endstep %}
{% step %}
Click **+Create** in the upper-right page corner.
{% endstep %}
{% step %}
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**.
{% endstep %}
{% step %}
In the **Driver** dropdown that appears, select **LuqaPay**.
{% endstep %}
{% step %}
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 environment
* `https://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.
{% endstep %}
{% step %}
Click **Save** to create the connection.
The **LuqaPay** connection will appear in the list of external connections.
{% endstep %}
{% step %}
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**.
{% endstep %}
{% step %}
Click **Save** to apply the changes.
{% endstep %}
{% endstepper %}
## Add a withdrawal method through LuqaPay
To add and set up a method for making withdrawals through LuqaPay:
{% stepper %}
{% step %}
In the B2CORE Back Office, navigate to **System** > **Payout system** > **Payout methods**.
{% endstep %}
{% step %}
Click **+Create** in the upper-right page corner.
{% endstep %}
{% step %}
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**.
{% endstep %}
{% step %}
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](#configure-a-connection-to-luqapay).
{% endstep %}
{% step %}
In the **Configuration** section, select **Türkiye** in the **Country** dropdown. This is the only supported country for this integration.
{% endstep %}
{% step %}
Click **Save** to create the withdrawal method.
The **LuqaPay** withdrawal method will appear in the list of withdrawal methods.
{% endstep %}
{% step %}
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](/how-to-articles/manage-payment-methods/how-to-configure-commissions-for-deposit-and-withdrawal-methods.md)).
LuqaPay withdrawal method — Settings tab
{% endstep %}
{% step %}
Click **Save** to apply the changes.
{% endstep %}
{% endstepper %}
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
{% stepper %}
{% step %}
In the B2CORE Back Office, navigate to **System** > **Payout system** > **Payout methods**.
{% endstep %}
{% step %}
Find the configured **LuqaPay** withdrawal method and click **Edit** to open the method details.
{% endstep %}
{% step %}
Go to the **Webhooks** tab.
{% endstep %}
{% step %}
Copy the URL displayed in the **Notification URL** field.
{% endstep %}
{% endstepper %}
### Provide the webhook URL to LuqaPay
Send the copied webhook URL to the LuqaPay support for configuration on their side.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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://docs.b2core.b2broker.com/how-to-articles/manage-payment-methods/how-to-add-deposit-and-withdrawal-methods-through-pss/how-to-integrate-luqapay.md?ask=
```
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.