LogoLogo
Release notesHomepageTry demo
  • Welcome to B2CORE docs
  • Integrations
    • Platforms
    • Payment systems
    • KYC providers
    • Communication platforms
    • Other systems
  • Back Office guide
    • Get started
    • Clients
      • General
        • Client tab
        • Contacts tab
        • Event log tab
        • Accounts tab
        • Transactions tab
        • Finance tab
        • History tab
        • Trades tab
        • Services tab
        • Files tab
        • Settings tab
        • Advanced tab
        • Compliances tab
        • Devices tab
        • Documents tab
        • Mailing Log tab
        • Introducing brokers tab
      • Services
      • Requests
      • Accounts
      • Managers
      • Types
      • Events log
      • Jurisdictions
    • Introducing brokers
    • Finance
      • Deposits
      • Payouts
      • Deposit wallets
      • Transfers
      • Exchange
      • Transactions
      • Reports
    • Savings
      • Presets
      • Plans
    • Bonuses
      • Bonus presets
      • Bonus distribution
      • Temporary bonuses
    • Currencies
      • Currencies
      • Rates
      • Currency pairs
    • Cashback
      • MetaTrader Volume
        • Preferences tab
        • Tiers tab
    • Products
      • Products
      • Groups
      • Rights
      • Platforms
    • Promotion
      • Banners
      • Announcements
      • Dashboard
      • Menu
    • Mailing
      • Marketing
      • System
    • Ticket feedback
    • Verification
      • Levels
      • Documents
      • Document types
      • Document groups
      • Client tests
    • Investment platform
    • System
      • SMS Providers
      • Key storage
      • Deposit system
      • Payout system
      • Wizards
      • Bulk actions
      • Operation types
      • Countries
      • External connections
      • Localizations
      • Requests
      • Templates
        • Email
        • SMS
        • Slack
        • Telegram
      • Logs
      • Settings
      • Event notifications
      • Users
        • Users
        • Groups
        • Client Tags
      • Events
      • Client rights
      • Client folders
      • Backend images
      • Import data
      • Visual customization
    • Security
      • Search by IP
      • Blocked clients
      • Black lists
      • White lists
      • Transaction monitoring
      • Address whitelist
      • Email black list
    • References
      • Client statuses
      • Client request statuses
      • Transaction statuses
      • Event types for triggering event notifications for Back Office users
      • Product permissions
      • Supported currencies
      • Supported cryptocurrency payment methods
      • Block explorer list
  • How-to articles
    • Manage clients
      • How to register a new client
      • How to change a client password
      • How to disable 2FA for a client
      • How to enable internal transfers for a client
      • How to view deposit or withdrawal wallet addresses
      • How to upload files to a client profile
      • How to assign tags to clients
      • How to approve or reject client requests
      • How to create categories for the Event log
      • How to create a jurisdiction
    • Manage finances
      • How to create a deposit
      • How to create a payout
      • How to create a transfer
      • How to exchange funds
      • How to create a report
      • How to update balances
      • How to process transactions with the Partial status
      • How to process transactions with the Assistance status
        • Move to Success
        • Move to In progress
        • Move to Failed
    • Manage savings programs
      • How to create a savings program
        • Configure the Flexible strategy settings
        • Configure the Fixed strategy settings
    • Manage currencies
      • How to add a currency
      • How to configure currency exchange rates
      • How to add an exchange currency pair
      • How to set priorities for exchange rate providers
      • How to enable requests for exchanges in specific currency pairs
      • How to update rates in exchange requests
    • Manage bonuses
      • How to create a bonus preset
      • How to create a temporary bonus program
      • How to automatically credit bonuses to clients upon deposits
      • How to manually credit bonuses to clients
    • Manage products
      • How to create a wallet
      • How to restrict the use of a product
    • Manage platforms
      • How to integrate B2TRADER
      • How to integrate DXtrade
      • How to integrate Match-Trader
      • How to integrate MetaTrader
      • How to integrate TradeLocker
      • How to integrate OneZero and PrimeXM
      • How to enable one-click trading access from the B2CORE UI and mobile app
    • Manage cashback options
      • How to configure cashback programs for MT4 and MT5
    • Manage advertising options
      • How to create a banner
      • How to create an announcement
      • How to configure the default Dashboard
      • How to add Ticker Widget symbols to the Dashboard
      • How to configure a menu in the B2CORE UI
    • Manage mailing options
      • How to send an email
      • How to create an email template
      • How to configure SMTP
      • How to configure SendGrid
      • How to determine why clients fail to receive email notifications
    • Manage verification options
      • How to use the KYC constructor
      • How to use SumSubstance
      • How to use ShuftiPro
      • How to use iDenfy
      • How to create a client accreditation test
    • Manage system settings
      • How to set up the Registration wizard
        • How to add and configure the Registration wizard
        • How to set up fields for the Basic Information step
        • Fields supported in the Basic Information step
        • How to set up fields for the Advanced step
        • Field types and validation rules
        • How to configure the User Registration step
      • How to change the wizard workflow
      • How to block registration for a country
      • How to add or remove a language
      • How to create a request resolution type
      • How to create a request resolution
      • How to set up event notifications
      • How to set up Apple push notification
      • How to add a user group and grant permissions
      • How to add an admin user
      • How to make an admin user see only specific clients
      • How to add a manager
      • How to create a bulk action
      • How to export a CSV file with email addresses
      • How to change Back Office images
      • How to set up 2FA
      • How to import client-related data
      • How to import data related to Back Office user groups
      • How to configure a connection to Zendesk
      • How to switch from SupportPal to Zendesk
      • How to configure a connection to RudderStack
      • How to configure settings for mobile app downloads
    • Manage payment methods
      • How to add non-PSS deposit and withdrawal methods
        • How to integrate B2BINPAY
      • How to add the manual deposit or withdrawal method
      • How to add the Constructor deposit or withdrawal method
      • How to add deposit and withdrawal methods through PSS
        • How to integrate BridgerPay
        • How to integrate ChipPay
        • How to integrate PayPal
        • How to integrate Paytiko
        • How to integrate Praxis
      • How to configure commissions for deposit and withdrawal methods
      • How to restrict the use of deposit and withdrawal methods
    • Manage communication platforms
      • How to configure Twilio
      • How to set up a Slack bot
      • How to set up a Telegram bot
      • How to get Telegram chat, group and channel identifiers
  • B2CORE Mobile
    • Deploying your iOS app
    • Deploying your Android app
  • B2CORE API
    • Restricted access to the API
  • Release notes
    • Release notes
    • Release notes Mobile
Powered by GitBook
On this page
  • How to add custom fields for the Constructor deposit or withdrawal method
  • How to upload a list of predefined options for a custom field
  • How to dynamically form a list of predefined options for a custom field

Was this helpful?

  1. How-to articles
  2. Manage payment methods

How to add the Constructor deposit or withdrawal method

Learn how to add and configure Constructor deposit and withdrawal methods in the B2CORE Back Office, enabling the addition of custom fields for clients to provide the necessary information

PreviousHow to add the manual deposit or withdrawal methodNextHow to add deposit and withdrawal methods through PSS

Last updated 8 days ago

Was this helpful?

You can use the Constructor method for deposits or withdrawals when customization is needed to meet specific requirements.

With Constructor methods, you can add and configure fields that clients must fill in when making deposits or withdrawals in the B2CORE UI. This flexibility is useful when additional details, such as bank information, payment references, or required documents, must be provided by clients.

By ensuring that all necessary information is collected, these methods help streamline deposit and withdrawal processing.

To add the Constructor method for deposits or withdrawals:

1

Navigate to System > Deposit system > Deposit methods or to System > Payout system > Payout methods.

2

Click +Create in the upper-right page corner.

3

On the Create method page, fill in the following fields:

  • In the Name field, enter a name for the method, such as Constructor. 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 Constructor.

  • In the displayed Currency dropdown, select a currency for deposits or withdrawals. After creating the method, you can add multiple currencies to it on the TR Currencies tab.

  • Leave the Connection dropdown empty.

4

Click Save to create the method.

The Constructor method will appear in the list of methods.

5

Click Edit to enter the method details and complete the following fields:

  • On the Settings tab, select one or more groups in which the method should be included, such as Fiat, Crypto, or both.

  • Review the currencies added on the TR Currencies and PS Currencies tabs, and add more if necessary (for tab descriptions, refer to or ).

  • Check the method status.

    Keep the method inactive (No is displayed in the Enabled field) until the method configuration is fully completed, including adding . Once done, activate the method.

6

Click Save to apply the changes.

The initial setup of the Constructor method is complete. Next, proceed with adding the required custom fields.

How to add custom fields for the Constructor deposit or withdrawal method

You can add and set up custom fields for deposit and withdrawal methods that use the Constructor provider.

To add a custom field:

1

Navigate to System > Deposit system > Deposit methods or to System > Payout system > Payout methods.

2

Select the deposit or withdrawal method that uses the Constructor provider.

3

Click Edit to enter the method details.

4

On the Settings tab, navigate to the Custom fields section, and then click Add field.

5

In the Add field popup, fill in the following fields:

  • In the Caption field, enter a field name. The name will be displayed in the B2CORE UI.

    You can optionally add localizations to the field name by clicking the button on the right side of the Caption field and providing translations for the required languages. When switching languages in the B2CORE UI, the field name will be displayed according to the selected language.

  • In the Type dropdown, select a field type. The following types are available:

    • Text — to add a text field.

    • Select with autocomplete — to add a field with predefined options. When a client begins typing in this field, options that match the entered characters are displayed, enabling the client to select the desired one.

    • File — to add a field for attaching a document necessary for depositing or withdrawing funds.

6

Click Save to add the custom field.

7

To configure properties of the newly added field, click the Edit button located in the field row:

  • In the displayed Main field settings section, you can make the field mandatory by selecting required in the Rules field.

  • For a field of the File type, in the Document type dropdown, select the type of a document that clients should attach. The list of available document types includes all the types configured on the Verification > Document types page.

    Clients can attach files in JPEG, PNG, or PDF format with the file size up to 3 MB.

8

Once you have completed the method configuration, activate it by selecting Yes in the Enabled dropdown.

9

Click Save to apply the changes.

When clients deposit or withdraw funds with the Constructor method, the added custom fields are displayed to them in the same order as they are listed in the Custom fields section of the Back Office.

How to upload a list of predefined options for a custom field

For each custom field of the Select with autocomplete type, you can automatically upload predefined options that clients can select when they deposit or withdraw funds in the B2CORE UI.

For example, instead of manually adding bank names as predefined options for the “Bank name” field, you can retrieve them from an appropriate resource defined for your application API.

To upload a list of predefined options for a custom field:

1

Navigate to the details of a deposit or withdrawal method that uses the Constructor provider.

2

On the Settings tab, navigate to the Custom fields section.

3

Select a field of the Select with autocomplete type for which you want to upload a list of predefined options (such as “Bank name”), and then click Edit.

4

Navigate to the Field dynamic options section, which is displayed below the Custom fields list, and specify the following fields:

  • In the Endpoint field, specify a URL of a specific API resource that includes field values that you want to use as predefined options for the selected custom field (such as the following sample endpoint: https://[host]/api/banks).

    The structure of the specified API resource is displayed in the Endpoint result preview field. The following example illustrates a possible resource structure:

Show example
[
  {
    "bankId": 1,
    "bankName": "Bank name 1",
    "countryCode": "AE",
    "countryName": "UAE"
  },
  {
    "bankId": 2,
    "bankName": "Bank name 2",
    "countryCode": "AE",
    "countryName": "UAE"
  },
  {
    "bankId": 3,
    "bankName": "Bank name 3",
    "countryCode": "GE",
    "countryName": "Georgia"
  },
  {
    "bankId": 4,
    "bankName": "Bank name 4",
    "countryCode": "GE",
    "countryName": "Georgia"
  },
  {
    "bankId": 5,
    "bankName": "Bank name 5",
    "countryCode": "MZ",
    "countryName": "Mozambique"
  }
]
  • In the Options from key dropdown, select the root element of the specified API resource (such as root).

  • In the Option value from key dropdown, select the resource field specifying the values of predefined options displayed for the custom field (such as bankId).

  • In the Option caption from key dropdown, select the resource field specifying the captions of the predefined options (such as bankName).

5

Click Save to apply the changes.

In the B2CORE UI, the list of predefined options for the “Bank name” custom field will include all the values retrieved from the bankName fields of the sample API resource.

How to dynamically form a list of predefined options for a custom field

A list of predefined options for a custom field can be formed dynamically, with the available options changing based on the selection made in an associated field.

For example, a list of predefined options for the “Bank name” field can depend on the country that is selected in the “Country” field.

To dynamically form a list of predefined options for a custom field:

1

Navigate to the details of a deposit or withdrawal method that uses the Constructor provider.

2

On the Settings tab, navigate to the Custom fields section.

3

Select a field of the Select with autocomplete type for which you want to form a dynamic list of predefined options (such as “Bank name”), and then click Edit.

4

Navigate to the Field dynamic options section, which is displayed below the Custom fields list, and specify the following field settings:

  • In the Depends on field dropdown, select another custom field (such as “Country”) that you want to associate with the “Bank name” field.

  • In the Depends on field by key dropdown, select the resource field that will be used to filter the options for the “Bank name” field (such as countryCode).

5

Click Save to apply the changes.

In the B2CORE UI, the list of bank names displayed for the “Bank name” field will be filtered based on the country selected by the client in the the “Country” field.

For a field of the Select with autocomplete type, add a list of predefined options. The options can be added manually or uploaded automatically by connecting to an appropriate API resource (for details, refer to )

To form dynamic lists of predefined options, both the associated custom fields must be populated with the options retrieved from the same API resource (for details, refer to ).

How to upload a list of predefined options for a custom field
How to upload a list of predefined options for a custom field
custom fields
Deposit methods
Constructor method setup: Part 1
Constructor method setup: Part 2
Constructor method setup: Part 3
Dynamic options for custom fields
Dynamic options for custom fields
Payout methods