Learn how to to integrate TopChange Pay with B2CORE through PSS for deposits and withdrawals. It covers setting up TopChange Pay connections, adding deposit and withdrawal methods, and verifying confi
Last updated
Was this helpful?
(TC Pay) can be connected to B2CORE through , with support for deposits and withdrawals in USD, IRR, EUR, AED, TRY, CNY, RUB, and USDT.
Follow the instructions below to configure the TC Pay connections and set up the deposit and withdrawal methods in the B2CORE Back Office. These instructions correspond to the for adding methods for PSS-supported payment systems, but include details specific to TC Pay.
If you plan to use TC Pay for both deposits and withdrawals, you must configure two separate connections: one for deposits and another for withdrawals.
To configure a connection to TC Pay:
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_TC_Pay or Withdrawals_TC_Pay).
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 TC Pay.
In the Credentials section that appears, configure the TC Pay-specific settings:
In the API base URL field, specify https://pg.toppayment.net.
In the Merchant ID field, enter the Merchant ID assigned to your account by TC Pay.
Generate a pair of RSA private and public keys using the TC RSA Key Generator.
You can consult the official or contact their support in case you have any questions.
In the Private RSA key field, specify the private key, and make sure to specify the corresponding public key in your TC Pay account.
Click Save to create the connection.
The TC Pay 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.
If you need to support both deposits and withdrawals via TC Pay, follow the same instruction to create a new connection for the other operation.
To add and set up a method for making deposits through TC Pay:
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 TC Pay will be available to accounts denominated in the selected currencies.
In the Driver dropdown, select TC Pay.
In the Connection dropdown, select the previously configured .
In the Configuration section, fill in the Terminal ID associated with your TC Pay merchant account. This ensures that transactions are correctly routed and attributed to the appropriate payment terminal. Note that the allowed currency is determined by the specified Terminal ID.
Click Save to create the deposit method.
The TC Pay 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 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 the needed currency. To enable the method to process deposits in a specific currency, ensure it is added on this tab.
For TC Pay, each deposit method can support only one currency under the PS Currencies tab. Therefore, if you want to allow your clients to deposit in all supported currencies (USD, IRR, EUR, AED, TRY, CNY, RUB, and USDT), you must create eight separate deposit methods — one for each currency, corresponding to the specified Terminal ID.
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 result will be displayed on the page.
After successfully validating the configuration, click Save.
The TC Pay deposit method is now configured in the B2CORE Back Office.
To add and set up a method for making withdrawals through TC Pay:
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 TC Pay will be available from accounts denominated in the selected currencies.
In the Driver dropdown, select TC Pay.
In the Configuration section, fill in the Terminal ID associated with your TC Pay merchant account. This ensures that transactions are correctly routed and attributed to the appropriate payment terminal. Note that the allowed currency is determined by the specified Terminal ID.
Click Save to create the withdrawal method.
The TC Pay 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 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 the needed currency. To enable the method to process withdrawals in a specific currency, ensure it is added on this tab.
For TC Pay, each withdrawal method can support only one currency under the PS Currencies tab. Therefore, if you want to allow your clients to withdraw in all supported currencies (USD, IRR, EUR, AED, TRY, CNY, RUB, and USDT), you must create eight separate withdrawal methods — one for each currency, corresponding to the specified Terminal ID.
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 TC Pay withdrawal method is now configured in the B2CORE Back Office.
In the Connection dropdown, select the previously configured .
If needed, configure commissions for the method on the Commissions tab (for details, refer to ).
