> 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-bridgerpay.md).

# How to integrate BridgerPay

[BridgerPay](https://bridgerpay.com/) can be connected to B2CORE through [PSS](/integrations/payment-systems.md#payment-system-service-pss), with support for deposits only.

Follow the instructions below to configure the BridgerPay connection and set up the deposit 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 BridgerPay.

{% hint style="info" %}
Before proceeding with the instructions, you must have signed up for BridgerPay and have an active account.
{% endhint %}

## Create a payment link in your BridgerPay account

To create a payment link in BridgerPay, you need to create a checkout of the payment link type:

{% stepper %}
{% step %}
Sign in to your BridgerPay account.
{% endstep %}

{% step %}
In the main menu, navigate to **Checkouts**.
{% endstep %}

{% step %}
Click the **plus** icon to add a new checkout, and then fill in the following fields:

* In the **Title** field, enter a title for the checkout.
* In the **Type** dropdown, select **Payment link**.

<figure><img src="/files/EKoKX7uNnrgY0wAktpbN" alt="Create a payment link in BridgerPay"><figcaption><p>Create a payment link in BridgerPay</p></figcaption></figure>
{% endstep %}

{% step %}
Click **Create**.
{% endstep %}
{% endstepper %}

After the checkout of the payment link type is successfully created, the required credentials for configuring the deposit method in the B2CORE Back Office will become available.

## Configure a connection to BridgerPay

To configure a connection to BridgerPay for making deposits:

{% 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, `Deposits_BridgerPay`).
* In the **Caption** field, enter a caption that will be applied to the connection in the Back Office.
* In the **Provider** dropdown, select **PaymentSystemDeposit**.
  {% endstep %}

{% step %}
In the **Driver** dropdown that appears, select **BridgerPay**.
{% endstep %}

{% step %}
In the **Credentials** section that appears, configure the BridgerPay-specific settings:

* In the **API base URL** field, specify `https://api.bridgerpay.com`.
* In the **API user name** and **API password** fields, enter your credentials for accessing the BridgerPay API.
* In the **API key** field, enter the API key generated in your BridgerPay account.
  {% endstep %}

{% step %}
Click **Save** to create the connection.

The **BridgerPay** 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 deposit method through BridgerPay

To add and set up a method for making deposits through BridgerPay:

{% stepper %}
{% step %}
In the B2CORE Back Office, navigate to **System** > **Deposit system** > **Deposit methods**.
{% endstep %}

{% step %}
Click **+Create** in the upper-right page corner.
{% endstep %}

{% step %}
On the **Create a deposit 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 **PaymentSystemDeposit**.
  {% endstep %}

{% step %}
After selecting **PaymentSystemDeposit**, the following fields appear:

* In the **Available account currencies** dropdown, select one or more currencies. Deposits through BridgerPay will be available to accounts denominated in the selected currencies.
* In the **Driver** dropdown, select **BridgerPay**.
* In the **Connection** dropdown, select the previously configured [BridgerPay connection](#configure-a-connection-to-bridgerpay).
  {% endstep %}

{% step %}
In the **Configuration** section that appears, complete the following setting:

* In the **Cashier key** field, specify the unique identifier provided by BridgerPay.

<figure><img src="/files/U93NlPIZThd50n3RLV2r" alt="Create the BridgerPay deposit method"><figcaption><p>Create the BridgerPay deposit method</p></figcaption></figure>
{% endstep %}

{% step %}
Click **Save** to create the deposit method.

The **BridgerPay** deposit method will appear in the list of deposit 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 `paymethod-bridgerpay` to display the [predefined icon](/integrations/payment-systems.md) for the BridgerPay deposit method in the B2CORE UI. To use a custom icon, specify the URL of the image to be displayed.
* 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**.
* Add the needed currencies on the **PS Currencies** tab. To enable the method to process deposits in a specific currency, ensure it is added on this tab (for the tab description, refer to [Deposit methods](/back-office-guide/system/deposit-system.md#details)).
* 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)).

<figure><img src="/files/tFbfarAy1Ve8RX0wFvKT" alt="BridgerPay deposit method — Settings tab"><figcaption><p>BridgerPay deposit method — Settings tab</p></figcaption></figure>
{% endstep %}

{% step %}
Click **Test configuration** to validate the connection settings of the deposit method. The test is performed based on the settings specified in the method form and the data provided in the selected external connection.

The test result will be displayed on the page.
{% endstep %}

{% step %}
After successfully validating the configuration, click **Save**.
{% endstep %}
{% endstepper %}

The **BridgerPay** deposit method is now configured in the B2CORE Back Office.

## Set up webhooks in your BridgerPay account

To receive status updates for initiated deposits in B2CORE, you need to set up notification webhooks for PSPs in BridgerPay.

### Copy the webhook URL from the B2CORE Back Office

{% stepper %}
{% step %}
In the B2CORE Back Office, navigate to **System** > **Deposit system** > **Deposit methods**.
{% endstep %}

{% step %}
Find the configured **BridgerPay** deposit method and click **Edit** to enter the method details.
{% endstep %}

{% step %}
Go to the **Webhooks** tab.
{% endstep %}

{% step %}
Copy the URL displayed in the **Notification URL** field.

<figure><img src="/files/HzcNpy2IbiiFKTcrtVPW" alt="BridgerPay deposit method — Webhooks tab"><figcaption><p>BridgerPay deposit method — Webhooks tab</p></figcaption></figure>
{% endstep %}
{% endstepper %}

### Add the webhook URL to PSPs in BridgerPay

{% stepper %}
{% step %}
Sign in to your BridgerPay account.
{% endstep %}

{% step %}
In the main menu, navigate to **Checkouts**.
{% endstep %}

{% step %}
Select the added PSP and click it to open its details.
{% endstep %}

{% step %}
In the details, click **Settings**.

<figure><img src="/files/xlrPKMzXzgW0LVgKpJBL" alt="PSP Settings in BridgerPay" width="360"><figcaption><p>PSP Settings in BridgerPay</p></figcaption></figure>
{% endstep %}

{% step %}
Go to the **URLs** tab.
{% endstep %}

{% step %}
Paste the webhook URL copied from the B2CORE Back Office into the **Webhook Notification URL** field.

<figure><img src="/files/c7rlGdbWecABqfpKFckS" alt="Add the webhook URL to a PSP in BridgerPay"><figcaption><p>Add the webhook URL to a PSP in BridgerPay</p></figcaption></figure>
{% endstep %}

{% step %}
Save your changes.
{% endstep %}
{% endstepper %}

Repeat these steps for each PSP added and configured in your BridgerPay account.

## Specify redirect URLs for PSPs in BridgerPay

To ensure proper redirection after a deposit is completed, failed, or canceled, set up the corresponding redirect URLs for PSPs in BridgerPay.

To st up redirect URLs:

{% stepper %}
{% step %}
In your BridgerPay account, navigate to **Checkouts** in the main menu.
{% endstep %}

{% step %}
Select the added PSP and click it to open its details.
{% endstep %}

{% step %}
In the details, click **Settings**.
{% endstep %}

{% step %}
Go to the **URLs** tab.
{% endstep %}

{% step %}
Specify the following URLs:

* In the **Success Redirect URL**, specify `https://{your-Front-Office-URL}/en/payment/success`.
* In the **Failure Redirect URL** and **Cancel Redirect URL** fields, specify `https://{your-Front-Office-URL}/en/payment/failed`.

{% hint style="info" %}
Make sure to replace `{your-Front-Office-URL}` with the domain of your B2CORE UI.
{% endhint %}

<figure><img src="/files/pgEr6MZKoKk1rGs2NZcK" alt="Add redirect URLs for a PSP in BridgerPay"><figcaption><p>Add redirect URLs for a PSP in BridgerPay</p></figcaption></figure>
{% endstep %}

{% step %}
Save your changes.
{% endstep %}
{% endstepper %}

Repeat these steps for each PSP added and configured in your BridgerPay account.

## Enable the 'Notify with original amount' option for PSPs in BridgerPay

The **Notify with original amount** option for PSPs in BridgerPay ensures that payment notifications include the original deposit amounts, without any modifications or additional charges.

To enable this option:

{% stepper %}
{% step %}
In your BridgerPay account, navigate to **Checkouts** in the main menu.
{% endstep %}

{% step %}
Select the added PSP and click it to open its details.
{% endstep %}

{% step %}
In the details, click **Settings**.
{% endstep %}

{% step %}
In the section named **PSP Specific Settings**, enable the **Notify with original amount** option.
{% endstep %}

{% step %}
Save your changes.
{% endstep %}
{% endstepper %}

Repeat these steps for each PSP added and configured in your BridgerPay account.

The **BridgerPay** deposit method is now fully configured and available for clients to use when making deposits in the B2CORE UI.


---

# 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-bridgerpay.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.