How to integrate Proxpay

Learn how to integrate Proxpay with B2CORE via PSS, including configuring connections and adding deposit and withdrawal methods with supported currencies

Proxpay can be connected to B2CORE through PSS. It supports deposits via QR codes and withdrawals to bank accounts, processed in THB.

Follow the instructions below to configure the Proxpay 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 Proxpay.

Before proceeding with the instructions, you must have signed up for Proxpay and have an active account.

Configure connections to Proxpay

If you plan to use Proxpay for both deposits and withdrawals, you must configure two separate connections: one for deposits and another for withdrawals.

To configure a connection to Proxpay:

1

In the B2CORE Back Office, navigate to System > External connections.

2

Click +Create in the upper-right page corner.

3

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_Proxpay or Withdrawals_Proxpay).

• 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.

4

In the Driver dropdown that appears, select Proxpay.

5

In the Credentials section that appears, configure the Proxpay-specific settings.

For deposits:

• In the API base URL field, specify:

  • https://api.proxpay.co — for the production environment

  • https://stg-api.proxpay.co — for the sandbox testing environment

• In the API key field, enter the API key provided by Proxpay to authenticate requests.

• In the Username and Password fields, specify the credentials associated with your Merchant ID.

• In the API start base URL field, specify https://payment.thehabito.com. This URL is only intended for the production environment and isn't available for the testing environment.

• In the Start token field, enter the token used to initiate API sessions with Proxpay.

• In the Merchant ID field, specify your Merchant ID assigned by Proxpay.

• In the Proxpay merchant ID filed, specify the unique merchant identifier used for QR code deposits.

For withdrawals:

• In the API base URL field, specify:

  • https://api.proxpay.co — for the production environment

  • https://stg-api.proxpay.co — for the sandbox testing environment

• In the API key field, enter the API key provided by Proxpay to authenticate requests.

• In the Username and Password fields, specify the credentials associated with your Merchant ID.

• In the Merchant ID field, specify your Merchant ID assigned by Proxpay.

You need to request all the credentials required for configuring connections from the Proxpay support.

6

Click Save to create the connection.

The Proxpay connection will appear in the list of external connections.

7

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.

8

Click Save to apply the changes.

If you need to support both deposits and withdrawals via Proxpay, follow the same instruction to create a new connection for the other operation.

Add a deposit method through Proxpay

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

1

In the B2CORE Back Office, navigate to System > Deposit system > Deposit methods.

2

Click +Create in the upper-right page corner.

3

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.

4

After selecting PaymentSystemDeposit, the following fields appear:

• In the Available account currencies dropdown, select one or more currencies. Deposits through Proxpay will be available to accounts denominated in the selected currencies. For these currencies, conversion rates for THB must be configured.

• In the Driver dropdown, select Proxpay.

• In the Connection dropdown, select the previously configured Proxpay connection for deposits.

5

In the Configuration section, enter the value for the Product detail field as provided by the Proxpay support.

6

Click Save to create the deposit method.

The Proxpay deposit method will appear in the list of deposit methods.

7

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 deposit 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 THB.

• If needed, configure commissions for the method on the Commissions tab (for details, refer to How to configure commissions for deposit and withdrawal methods).

Proxpay deposit method — Settings tab

8

Click Test configuration to validate the connection settings of the deposit method.

The test result will be displayed on the page.

9

After successfully validating the configuration, click Save.

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

Add a withdrawal method through Proxpay

To add and set up a method for making withdrawals through Proxpay:

1

In the B2CORE Back Office, navigate to System > Payout system > Payout methods.

2

Click +Create in the upper-right page corner.

3

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.

4

After selecting PaymentSystemWithdrawal, the following fields appear:

• In the Available account currencies dropdown, select one or more currencies. Withdrawals through Proxpay will be available from accounts denominated in the selected currencies. For these currencies, conversion rates for THB must be configured.

• In the Driver dropdown, select Proxpay.

• In the Connection dropdown, select the previously configured Proxpay connection for withdrawals.

5

Skip the Configuration section, as no settings are required for the Proxpay withdrawal method.

6

Click Save to create the withdrawal method.

The Proxpay withdrawal method will appear in the list of withdrawal methods.

7

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 THB.

• If needed, configure commissions for the method on the Commissions tab (for details, refer to How to configure commissions for deposit and withdrawal methods).

Proxpay withdrawal method — Settings tab

8

Click Test configuration to validate the connection settings of the withdrawal method.

The test result will be displayed on the page.

9

After successfully validating the configuration, click Save.

The Proxpay withdrawal method is now configured in the B2CORE Back Office.

Set up webhooks in Proxpay

To receive status updates for deposits and withdrawals in B2CORE, notification webhooks must be set up on the side of Proxpay.

Copy webhook URLs from the B2CORE Back Office

You will need separate webhook URLs for both deposit and withdrawal methods.

1

In the B2CORE Back Office, navigate to:

• System > Deposit system > Deposit methods

• System > Payout system > Payout methods

2

Find the configured Proxpay deposit or withdrawal method and click Edit to open its details.

3

Go to the Webhooks tab.

4

Copy the URL displayed in the Notification URL field.

Provide URLs to Proxpay

Send the copied webhook URLs (for both deposits and withdrawals) to the Proxpay support for configuration on their side.