Learn how to integrate PayPal with B2CORE through PSS for deposits and withdrawals. It covers setting up PayPal connections, adding deposit and withdrawal methods, and verifying configurations
Last updated
Was this helpful?
PayPal can be connected to B2CORE only through PSS, with support for deposits and withdrawals.
Follow the instructions below to configure the PayPal connections and set up the deposit and withdrawal methods 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 PayPal.
If you plan to use PayPal for both deposits and withdrawals, you must configure two separate connections: one for deposits and another for withdrawals.
To configure a connection to PayPal:
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_PayPal or Withdrawals_PayPal).
In the Caption field, enter a caption that will be applied to the connection in the Back Office.
In the Provider dropdown, select:
PaymentSystemDeposit — to add a connection that will be used for a deposit method.
PaymentSystemWithdrawal — to add a connection that will be used for a withdrawal method.
In the Driver dropdown that appears, select PayPal.
In the Credentials section that appears, configure the PayPal-specific settings:
In the API base URL field, specify https://api-m.paypal.com.
In the Client ID field, enter the ID of the REST API app that you created in your PayPal account.
In the Client secret field, enter the client secret associated with that app.
To find your client ID and secret, sign in to your PayPal account and navigate to My Apps & Credentials in the main menu. On the Live tab, select your app to view and copy the credentials.
Click Save to create the connection.
The PayPal connection for deposits or withdrawals 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.
If you need to support both deposits and withdrawals via PayPal, follow the same instruction to create a new connection for the other operation.
To add and set up a method for making deposits through PayPal:
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 PayPal will be available to accounts denominated in the selected currencies.
In the Driver dropdown, select PayPal.
In the Connection dropdown, select the previously configured PayPal connection for deposits.
In the Configuration section that appears, configure the following parameter:
In the Amount type dropdown, select how the final deposit amount will be calculated:
Net amount (the default option) — the amount received by the broker after PayPal transaction fees are deducted. If no commission is set for the method in B2CORE, this net amount will be deposited to the client’s account. If a commission is set, it will be deducted from the net amount, and the client will receive a smaller amount. In both cases, the broker doesn't incur any losses.
Gross amount — the full deposit amount before PayPal transaction fees are deducted. If no commission is set for the method in B2CORE, the broker will receive less than the gross amount due to PayPal fees and will have to cover the difference, resulting in a loss.
For more details on setting commissions, refer to How to configure commissions for deposit and withdrawal methods.
Click Save to create the deposit method.
The PayPal 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-paypal to display the predefined icon for the PayPal 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).
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 Test configuration to validate the connection settings of the deposit method.
The test result will be displayed on the page.
After successfully validating the configuration, click Save.
The PayPal deposit method is now configured in the B2CORE Back Office.
To add and set up a method for making withdrawals through PayPal:
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 PayPal will be available from accounts denominated in the selected currencies.
In the Driver dropdown, select PayPal.
In the Connection dropdown, select the previously configured PayPal connection for withdrawals.
Skip the Configuration section, as no settings are required for the PayPal withdrawal method.
Click Save to create the withdrawal method.
The PayPal 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 paymethod-paypal to display the predefined icon for the PayPal withdrawal 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 withdrawals in a specific currency, ensure it is added on this tab (for the tab description, refer to Payout methods).
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 Test configuration to validate the connection settings of the withdrawal method.
The test result will be displayed on the page.
After successfully validating the configuration, click Save.
The PayPal withdrawal method is now configured in the B2CORE Back Office.
