How to integrate BridgerPay
Last updated
Was this helpful?
Last updated
Was this helpful?
can be connected to B2CORE through , 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 for adding methods for PSS-supported payment systems, but include details specific to BridgerPay.
To create a payment link in BridgerPay, you need to create a checkout of the payment link type:
Sign in to your BridgerPay account.
In the main menu, navigate to Checkouts.
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.
Click Create.
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.
To configure a connection to BridgerPay for making deposits:
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, 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.
In the Driver dropdown that appears, select BridgerPay.
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.
Click Save to create the connection.
The BridgerPay 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.
To add and set up a method for making deposits through BridgerPay:
In the B2CORE Back Office, navigate to System > Deposit system > Deposit methods.
Click +Create in the upper-right page corner.
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.
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 .
In the Configuration section that appears, complete the following setting:
In the Cashier key field, specify the unique identifier provided by BridgerPay.
Click Save to create the deposit method.
The BridgerPay deposit method will appear in the list of deposit 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 paymethod-bridgerpay to display the 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 ).
If needed, configure commissions for the method on the Commissions tab (for details, refer to ).
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.
After successfully validating the configuration, click Save.
The BridgerPay deposit method is now configured in the B2CORE Back Office.
To receive status updates for initiated deposits in B2CORE, you need to set up notification webhooks for PSPs in BridgerPay.
In the B2CORE Back Office, navigate to System > Deposit system > Deposit methods.
Find the configured BridgerPay deposit method and click Edit to enter the method details.
Go to the Webhooks tab.
Copy the URL displayed in the Notification URL field.
Sign in to your BridgerPay account.
In the main menu, navigate to Checkouts.
Select the added PSP and click it to open its details.
In the details, click Settings.
Go to the URLs tab.
Paste the webhook URL copied from the B2CORE Back Office into the Webhook Notification URL field.
Save your changes.
Repeat these steps for each PSP added and configured in your BridgerPay account.
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:
In your BridgerPay account, navigate to Checkouts in the main menu.
Select the added PSP and click it to open its details.
In the details, click Settings.
Go to the URLs tab.
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.
Save your changes.
Repeat these steps for each PSP added and configured in your BridgerPay account.
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:
In your BridgerPay account, navigate to Checkouts in the main menu.
Select the added PSP and click it to open its details.
In the details, click Settings.
In the section named PSP Specific Settings, enable the Notify with original amount option.
Save your changes.
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.
