# How to integrate Sticpay

[Sticpay](https://www.sticpay.com/) can be connected to B2CORE through [PSS](/integrations/payment-systems.md#payment-system-service-pss), with support for deposits and withdrawals.

Follow the instructions below to configure the Sticpay connection and set up the deposit and withdrawal methods in the B2CORE Back Office. These instructions correspond to the [General procedure](/how-to-articles/manage-payment-methods/how-to-add-deposit-and-withdrawal-methods-through-pss.md) for adding methods for PSS-supported payment systems, but include details specific to Sticpay.

{% hint style="info" %}
Before proceeding with the instructions, you must have signed up for Sticpay and have an active account.
{% endhint %}

## Supported currencies

Below are the tables listing the currencies supported for deposits and withdrawals via Sticpay. Transactions are processed through wallets created in your Sticpay account. To enable a particular currency, you must first create a wallet in that currency.

### Fiat currencies

The following fiat currencies are supported for **both deposits and withdrawals**:

| Alpha code | Name                        |
| ---------- | --------------------------- |
| AED        | United Arab Emirates dirham |
| ARS        | Argentine peso              |
| AUD        | Australian dollar           |
| BRL        | Brazilian real              |
| CAD        | Canadian dollar             |
| CHF        | Swiss franc                 |
| CLP        | Chilean peso                |
| CNY        | Chinese yen                 |
| COP        | Colombian peso              |
| EUR        | Euro                        |
| GBP        | Pound sterling              |
| HKD        | Hong Kong dollar            |
| HUF        | Hungarian forint            |
| IDR        | Indonesian rupiah           |
| INR        | Indian rupee                |
| JPY        | Japanese yen                |
| KHR        | Cambodian riel              |
| KRW        | South Korean won            |
| MXN        | Mexican peso                |
| MYR        | Malaysia ringgit            |
| NPR        | Nepalese rupee              |
| NZD        | New Zealand dollar          |
| PEN        | Peruvian sol                |
| PHP        | Philippines peso            |
| PLN        | Polish złoty                |
| RUB        | Russian ruble               |
| SGD        | Singapore dollar            |
| THB        | Thailand baht               |
| TRY        | Turkish lira                |
| USD        | US dollar                   |
| VND        | Vietnamese dong             |

### Cryptocurrencies

The following cryptocurrencies are supported for **deposits only**:

| Alpha code | Name     |
| ---------- | -------- |
| BTC        | Bitcoin  |
| ETH        | Ethereum |
| LTC        | Litecoin |
| MATIC      | Polygon  |
| NESS       | Ness     |
| USDT       | Tether   |

## Minimum deposit and withdrawal amounts

Sticpay applies a dynamic minimum amount to deposits and withdrawals, equivalent to **1 USD** based on Sticpay’s exchange rates. If a deposit or withdrawal request is created below this minimum threshold (in conversion to USD), Sticpay will reject the transaction.

For deposits, a client will see an error if the amount is below the limit when redirected to the Sticpay page.

{% hint style="warning" %}
For withdrawals, if the amount is below the limit, the transaction will fail when processed on the Sticpay side, and the client won’t see the reason for the failure. To prevent this, it is strongly recommended to configure a minimum withdrawal amount for each supported currency in the Sticpay withdrawal method in the B2CORE Back Office.
{% endhint %}

## Configure API settings in your Sticpay account

To enable integration between Sticpay and B2CORE, you need to configure specific API settings in your Sticpay account.

To configure API settings:

{% stepper %}
{% step %}
Sign in to your Sticpay account and navigate to the **Sticpay API** section.
{% endstep %}

{% step %}
Configure the following settings, which are required for deposit and withdrawal methods to function correctly with B2CORE:

* Select the **Enable** checkbox to activate API-based payments.
* Select the **Unique order-no** checkbox to ensure that each transaction has a unique order number, preventing duplicates.
* In the **Success URL** field, specify the URL to which clients will be redirected after a successful deposit, using the format:

  `https://{your-Front-Office-URL}/en/payment/success`
* In the **Failure URL** field, specify the URL to which clients will be redirected after a failed deposit, using the format:

  `https://{your-Front-Office-URL}/en/payment/failed`
* In the **Referrer URL** field, specify the URL to which clients will be redirected after canceling a deposit (for example, the **Funds** > **Deposit** page of your B2CORE UI), using the format:

  `https://{your-Front-Office-URL}/en/funds/deposit`

{% hint style="info" %}
Make sure to replace `{your-Front-Office-URL}` with the domain of your B2CORE UI.
{% endhint %}

* In the **Callback URL** field, enter the webhook URL generated on the **Webhooks** tab of the deposit method settings after configuring the method in the B2CORE Back Office (for details, refer to [Set up a webhook in your Sticpay account](#set-up-a-webhook-in-your-sticpay-account)).
* Select the **Plain JSON Callback** checkbox to ensure callback responses are formatted as plain JSON.
* In the **Whitelist IPs** field, enter the comma-separated IP addresses from which requests to your API will be accepted.
* In the **Encryption type** dropdown, select **SHA256** to use this encryption method for request signing and validation. Only **SHA256** is supported for integration with B2CORE.

<figure><img src="/files/hObnddtNpmTBSlAJxR1x" alt="Sticpay API settings"><figcaption><p>Sticpay API settings</p></figcaption></figure>
{% endstep %}

{% step %}
Click **Save** to apply your changes.
{% endstep %}
{% endstepper %}

## Configure connections to Sticpay

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

To configure a connection to Sticpay:

{% stepper %}
{% step %}
In the B2CORE Back Office, navigate to **System** > **External connections**.
{% endstep %}

{% step %}
Click **+Create** in the upper-right page corner.
{% endstep %}

{% step %}
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_Sticpay` or `Withdrawals_Sticpay`).
* 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.
    {% endstep %}

{% step %}
In the **Driver** dropdown that appears, select **Sticpay**.
{% endstep %}

{% step %}
In the **Credentials** section that appears, configure the Sticpay-specific settings:

* In the **Interface version** dropdown, select **Live** or **Sandbox**, depending on whether you're setting up a production or test integration.
* In the **API base URL** field, specify `https://api.sticpay.com`, which is used for both production and sandbox environments.
* In the **Merchant email** field, enter the email address associated with your Sticpay merchant account. The email can be found in the **Account** section.
* In the **API key** field, enter the API key generated in the **Sticpay API** section of your account.
  {% endstep %}

{% step %}
Click **Save** to create the connection.

The **Sticpay** connection will appear in the list of external connections.
{% endstep %}

{% step %}
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**.
{% endstep %}

{% step %}
Click **Save** to apply the changes.
{% endstep %}
{% endstepper %}

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

## Add a deposit method through Sticpay

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

{% stepper %}
{% step %}
In the B2CORE Back Office, navigate to **System** > **Deposit system** > **Deposit methods**.
{% endstep %}

{% step %}
Click **+Create** in the upper-right page corner.
{% endstep %}

{% step %}
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**.
  {% endstep %}

{% step %}
After selecting **PaymentSystemDeposit**, the following fields appear:

* In the **Available account currencies** dropdown, select one or more currencies. Deposits through Sticpay will be available to accounts denominated in the selected currencies.
* In the **Driver** dropdown, select **Sticpay**.
* In the **Connection** dropdown, select the previously configured [Sticpay connection for deposits](#configure-connections-to-sticpay).
  {% endstep %}

{% step %}
Skip the **Configuration** section, as no settings are required for the Sticpay deposit method.
{% endstep %}

{% step %}
Click **Save** to create the deposit method.

The **Sticpay** deposit method will appear in the list of deposit methods.
{% endstep %}

{% step %}
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-sticpay` to display the [predefined icon](/integrations/payment-systems.md) for the Sticpay 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 the needed currencies. To enable the method to process deposits in a specific currency, ensure it is added on this tab.
* If needed, configure commissions for the method on the **Commissions** tab (for details, refer to [How to configure commissions for deposit and withdrawal methods](/how-to-articles/manage-payment-methods/how-to-configure-commissions-for-deposit-and-withdrawal-methods.md)).

<figure><img src="/files/mhd1CJ8OuI8iOFf14dwR" alt="Sticpay deposit method — Settings tab"><figcaption><p>Sticpay deposit method — Settings tab</p></figcaption></figure>
{% endstep %}

{% step %}
Click **Test configuration** to validate the connection settings of the deposit method.

The test result will be displayed on the page.
{% endstep %}

{% step %}
After successfully validating the configuration, click **Save**.
{% endstep %}
{% endstepper %}

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

## Set up a webhook in your Sticpay account

To receive status updates for initiated deposits in B2CORE, you need to set up a notification webhook in your Sticpay account.

### Copy the webhook URL from the B2CORE Back Office

{% stepper %}
{% step %}
In the B2CORE Back Office, navigate to **System** > **Deposit system** > **Deposit methods**.
{% endstep %}

{% step %}
Find the configured **Sticpay** deposit method and click **Edit** to enter the method details.
{% endstep %}

{% step %}
Go to the **Webhooks** tab.
{% endstep %}

{% step %}
Copy the URL displayed in the **Notification URL** field.
{% endstep %}
{% endstepper %}

### Add the webhook URL to your Sticpay account

{% stepper %}
{% step %}
In your Sticpay account, navigate to the **Sticpay API** section.
{% endstep %}

{% step %}
Paste the copied webhook URL into the **Callback URL** field.
{% endstep %}

{% step %}
Click **Save** to apply the changes.
{% endstep %}
{% endstepper %}

## Add a withdrawal method through Sticpay

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

{% stepper %}
{% step %}
In the B2CORE Back Office, navigate to **System** > **Payout system** > **Payout methods**.
{% endstep %}

{% step %}
Click **+Create** in the upper-right page corner.
{% endstep %}

{% step %}
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**.
  {% endstep %}

{% step %}
After selecting **PaymentSystemWithdrawal**, the following fields appear:

* In the **Available account currencies** dropdown, select one or more currencies. Withdrawals through Sticpay will be available from accounts denominated in the selected currencies.
* In the **Driver** dropdown, select **Sticpay**.
* In the **Connection** dropdown, select the previously configured [Sticpay connection for withdrawals](#configure-connections-to-sticpay).
  {% endstep %}

{% step %}
Skip the **Configuration** section, as no settings are required for the Sticpay withdrawal method.
{% endstep %}

{% step %}
Click **Save** to create the withdrawal method.

The **Sticpay** withdrawal method will appear in the list of withdrawal methods.
{% endstep %}

{% step %}
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-sticpay` to display the [predefined icon](/integrations/payment-systems.md) for the Sticpay withdrawal method in the B2CORE UI. To use a custom icon, specify the URL of the image to be displayed.

  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 currencies. To enable the method to process withdrawals in a specific currency, ensure it is added on this tab.

{% hint style="warning" %}
Sticpay applies a dynamic minimum withdrawal amount, equivalent to **1 USD** based on Sticpay's exchange rates.

If a withdrawal is created below this minimum, the transaction will fail when processed on the Sticpay side, and the client won’t see the reason for the failure. To prevent this, specify a minimum amount for each currency (in conversion to USD) when adding it to the **PS Currencies** tab.
{% endhint %}

* If needed, configure commissions for the method on the **Commissions** tab (for details, refer to [How to configure commissions for deposit and withdrawal methods](/how-to-articles/manage-payment-methods/how-to-configure-commissions-for-deposit-and-withdrawal-methods.md)).

<figure><img src="/files/3Xl2P331qCSMBH6wfEvp" alt="Sticpay withdrawal method — Settings tab"><figcaption><p>Sticpay withdrawal method — Settings tab</p></figcaption></figure>
{% endstep %}

{% step %}
Click **Test configuration** to validate the connection settings of the withdrawal method.

The test result will be displayed on the page.
{% endstep %}

{% step %}
After successfully validating the configuration, click **Save**.
{% endstep %}
{% endstepper %}

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.b2core.b2broker.com/how-to-articles/manage-payment-methods/how-to-add-deposit-and-withdrawal-methods-through-pss/how-to-integrate-sticpay.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
