How to integrate ChipPay
Last updated
Was this helpful?
Last updated
Was this helpful?
ChipPay can be connected to B2CORE through , with support for deposits and withdrawals.
ChipPay processes payments in CNY, which serves as its settlement currency, while the B2CORE PPS sends and receives amounts to and from ChipPay in USDT. For this reason, USDT must be added as a PS currency in the deposit and withdrawal methods configured in B2CORE.
Follow the instructions below to configure the ChipPay 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 ChipPay.
If you plan to use ChipPay for both deposits and withdrawals, you must configure separate connections, each dedicated to a specific deposit or withdrawal method.
Each connection must be configured with the appropriate driver to ensure the correct operation of the respective deposit or withdrawal method.
To configure a connection to ChipPay:
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_ChipPay or Withdrawals_ChipPay).
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:
ChipPay order — for deposits processed through ChipPay payment orders. Clients can pay using one of the available methods configured in your ChipPay merchant account, such as bank cards, AliPay, or WeChat Pay, if those options are enabled.
ChipPay deal — for deposits via bank card payments.
ChipPay — for withdrawals via bank card payments.
In the Credentials section that appears, configure the ChipPay-specific settings:
In the API base URL field, specify https://open-v2.chippay.com/.
In the Merchant ID field, enter your ChipPay Merchant ID.
Generate a pair of 4096-bit RSA private and public keys using a secure tool, such as OpenSSL or another trusted method.
In the Private key field, specify the private key, and make sure to specify the corresponding public key in your ChipPay account.
Click Save to create the connection.
The ChipPay 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 additional ChipPay connections for other payment methods, follow the same instruction to create a new connection with a different driver.
The image below displays three configured ChipPay connections: one for the withdrawal method and two for deposit methods.
To add and set up a method for making deposits through ChipPay:
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 ChipPay will be available to accounts denominated in the selected currencies.
In the Driver dropdown, select ChipPay order or ChipPay deal.
In the Connection dropdown, select the previously configured ChipPay connection for deposits.
If you selected the ChipPay order driver, skip the Configuration section, as no settings are required for this deposit method.
If you selected the ChipPay deal driver, in the Configuration section that appears, fill in the following fields:
In the Exchange rate adjustment dropdown, select:
Yes — to adjust the exchange rate provided by ChipPay when converting deposited funds into CNY, which is the settlement currency used by ChipPay for processing payments.
No — to use the default rate provided by ChipPay.
If you selected Yes, specify the adjustment value (as a percentage) in the Adjustment value field. The rate can only be adjusted within a ±3% range. For example, entering 3 increases the exchange rate by 3%, while -3 decreases it by 3%.
The adjusted rate will appear in the details of the ChipPay order created to process the deposit.
Click Save to create the deposit method.
The ChipPay 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-chippay to display the predefined icon for the ChipPay 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.
On the PS Currencies tab, add USDT.
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 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 ChipPay deposit method is now configured in the B2CORE Back Office.
If you want to support both deposit methods offered by ChipPay, add and set up another deposit method that uses a different driver and connection.
To add and set up a method for making withdrawals through ChipPay:
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 ChipPay will be available from accounts denominated in the selected currencies.
In the Driver dropdown, select ChipPay.
In the Connection dropdown, select the previously configured ChipPay connection for withdrawals.
Skip the Configuration section, as no settings are required for ChipPay withdrawals.
Click Save to create the withdrawal method.
The ChipPay 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-chippay to display the predefined icon for the ChipPay 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.
On the PS Currencies tab, add USDT.
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 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 ChipPay withdrawal method is now configured in the B2CORE Back Office.
