How-to Articles

How to Register in B2BinPay

#enterprise #merchant

Before starting your registration process, choose the most convenient language from the drop-down list in the upper right corner of your screen.

  1. Select your account type — Enterprise or Merchant.

  2. Fill out the following fields:

  • First name — required field: enter your first name

  • Last name — required field: enter your last name

  • E-mail — required field: enter your email

  • Mobile number — required field: choose your country code from the drop-down list and enter your mobile number

  • Other contact information — enter any additional information you consider necessary. Note that the field has character number restriction

  • Language — from the drop-down list select the communication language

  • Legal entity name — required field: enter the legal name of your organization

  • Country of incorporation — required field: from the drop-down list, select the country of registration of your organization

  • Other business name — enter other name of your organization, if you have any (for example, the brand name, etc.)

  • Place of business operations — required field: select the place of your business operation from the drop-down list

  • Type of business — required field: select the type of your business from the drop-down list

  • Global number of employees — required field: select the number of employees from the drop-down list

  • Company website — add your company website

  • Business description — required field: add a description of your business. Note that the field has character number restriction

  • New password — required field: enter a password for your account. Make sure you use a strong password consisting of letters of different registers, numbers and special symbols

  • Confirm password — re-enter the password to confirm it

  1. Check Agree with AML Policy and Agree with Terms of Use, Privacy Policy. Make sure to read these Policies carefully before checking the checkboxes.

  2. Click Sign up. After clicking the button, you will be redirected to the authorization form.

  3. Enter your email and password, specified at registration, then click Submit. You will be redirected to the verification by email form. Also an email with confirmation code will be sent to the email address specified at registration.

  4. Enter the confirmation code from the email on the verification form and click Send. You will be redirected to the verification by phone number form.

  5. Enter the confirmation code from SMS, sent to your phone number, on the verification form and click Send.

Note

If you failed to receive an SMS with the confirmation code, click the Resend button. The confirmation code can be resent no more than 3 times an hour with 1 minute interval. If you do not receive the confirmation code after clicking Resend, contact our technical support service.

Now you can log in with the email and password, specified at registration, to use all functions of B2BinPay.

How to Protect Your Account

#enterprise #merchant

Make sure everyone on your team follows these guidelines:

  1. Use strong passwords consisting of letters of different registers, numbers and special symbols. We recommend using password managers. Ref. to How to Change Your Password for a description of changing the password.

  2. Never give your password to anyone.

  3. Enable 2FA.

Important

We strongly recommend that you enable 2FA as it adds an additional layer of security to your account. 2FA is a uniquely generated code which you have to enter after entering your login and password. The code can be used only once and must be entered before it expires.

You can use either your email or Google Authenticator for receiving 2FA verification codes. We recommend the latter as it is more reliable, and it will be more difficult for attackers to gain access to your device than to your email. However, remember that if you lose your device or forget the secret code, you can restore access to your account only through the account manager and you’ll need to provide all the necessary documents to verify your identity. Ref. to How to Enable 2FA for a description of 2FA enabling.

If you are the Owner:

  1. Regenerate API keys after integration is configured and working.

API keys are sent to your email after registration in the system. If you share these keys with the developers, make sure after setup to regenerate the keys to reset access. Ref. to How to Manage API Access for a description of API keys regenerating.

  1. Manage access rights carefully.

Make sure that your users have access only to those wallets and operations that they need to complete their tasks. Use Withdrawals with approval option. Ref. to How to Grant Access to Your Wallet for a description of user roles management.

  1. Specify IP white list for API operations.

Ref. to How to Restrict Access by IP for a description of IP white list settings.

We also recommend:

  • Specify white list of IP addresses

Not only for API operations but also for accessing the system interface. You can specify separate IP addresses or subnet mask (for example, of your office). Note that the specified IP addresses must be static, not dynamic! Ref. to How to Restrict Access by IP for a description of IP white list settings.

  • Enable notifications for each wallet

You will receive notifications about all operations with the wallet, and you can quickly find out about suspicious transactions. Ref. to Wallet Settings in the User Guide for Enterprise for description of notifications enabling for Enterprise users and to Wallet Settings in the User Guide for Merchants for description of notifications enabling for Merchant users.

What to do if you suspect your account has been hacked

  1. Change your password as soon as possible.

Note, that password changing takes time in the system. If you use Google Authenticator, switch it off and on Google to receive a new 2FA verification code.

  1. Reset access rights and IP white lists.

At least for a while. Assign Read only or Withdrawals with approval role to all users who have access to wallets. Limit the list of IP addresses from which access to the system interfaces is allowed.

  1. Inform your account manager about suspicious operations or activity.

How to Change Your Password

#enterprise #merchant

  1. Navigate to Control panel > Settings.

  2. Enter new password in the New password field. Make sure your password is strong and consists of letters of different registers, numbers and special characters.

  3. Re-enter new password to confirm it.

  4. Click Save.

If you forgot your password, click the Forgot password link to reset it.

How to Enable 2FA

#enterprise #merchant

  1. Navigate to Control panel > Settings.

  2. Check 2FA enabled, then click Next.

  3. Select the confirmation method — we support two methods:

  • Google Authenticator: download and install “Google authenticator” application and scan the QR code or enter the secret key. This will set up your account on your device, you will then be able to view the account and it will generate a 6-digit code that you must enter to verify and complete the set up. Please ensure to click the Verify button before the code expires. Your server time will need to be in sync with NTP server to function properly. Google Authenticator app is available in Google Play and AppStore

  • Email: your email address will be used to send temporary codes. Please, make sure you have access to your email

  1. Click Save.

How to Manage API Access

#enterprise #merchant

  1. Navigate to Control panel > API access.

  2. In the White list field, type a comma-separated list of IP addresses which are allowed to access your wallets and transactions by API. Don’t forget to save changes by clicking the Save button. We recommend using this option to protect your account.

  3. Click Save.

How to Restrict Access by IP

#enterprise #merchant

You can restrict access to the interface of B2BinPay by IP.

  1. Navigate to Control panel > Settings.

  2. In the Security field, type a comma-separated list of IP addresses which are allowed to access your wallets and transactions.

  3. Click Save.

Now only the users specified in the list of IP addresses are allowed to access your account.

How to Create a Wallet

For Enterprise User

#enterprise

  1. Navigate to Wallets > All wallets.

  2. Click New Wallet.

  3. Fill out the form:

  • Currency — required field: select the wallet currency from the list of available currencies. Note that this value cannot be changed after the wallet is created

  • Parent wallet — if a wallet in tokens is created, it requires a parent wallet in coins. Note, that you cannot link two token-wallets to one parent coin-wallet

  • Label — the label of the wallet is displayed in the list and is used for quick search, can be any name convenient for you

  1. If needed, set the Advanced options:

  • Minimal transfer amount — the system will not automatically accept payments less than the specified amount (in wallet currency). This can be useful in case when transaction fee is more than transaction amount. The callback will not be sent, you will see a new transfer with Cancelled status (ref. to Transfers for details). You will also receive a notification in the Events: here you can confirm and accept such transfers manually. You can set a minimal transfer amount manually while creating a new wallet. Otherwise a minimal transfer amount is set automatically after a new wallet is created. The value of the automatically set minimal transfer amount is valid for the moment of creation of a certain wallet. This value can be changed or deleted manually after the wallet is created.

  • Notification addresses — comma-separated list of email addresses, to which notifications about new transactions and other operations with the wallet will be sent

  1. Click Save.

Note

When created, your new wallet will be assigned with In progress status for several minutes. This is required for wallet to be registered in the system. While in progress, the wallet cannot be used for any transfers.

To activate a wallet with ETH, XRP, XLM or BNB currencies, you have to make a deposit to your wallet. The depositing address is available in the Wallet address field in wallet settings. The deposited amount will be blocked, and your wallet will be assigned with Active status. The depositing amount depends on the chosen currency and may vary.

For Merchant User

#merchant

  1. Navigate to Wallets > All wallets.

  2. Click New Wallet.

  3. Fill out the form:

  • Currency — required field: select the wallet currency from the list of available currencies. Note that this value cannot be changed after the wallet is created

  • Label — the label of the wallet is displayed in the list and is used for quick search, can be any name convenient for you

  • Site URL — specify URL address of your company website

  1. If needed, set the Advanced options:

  • Notification addresses — comma-separated list of email addresses, to which notifications about new transactions and other operations with the wallet will be sent

  1. Click Save.

Note

When created, your new wallet will be assigned with In progress status for several minutes. This is required for wallet to be registered in the system. While in progress, the wallet cannot be used for any transfers.

How to Grant Access to Your Wallet

#enterprise #merchant

  1. Navigate to Wallets.

  2. Select the wallet and go to Settings of the selected wallet.

  3. Click Advanced options and go to the Access rights field.

  4. Type the user email in the Invite new user field.

  5. Click Invite to invite the user. The user will receive an invitation by email with a link to activate an access to the wallet.

The new user is added by default with a Read only role that can be changed immediately.

Ref. to Managing Access in the Quick Start Guide for more details.

How to Restrict Access to Your Wallet

#enterprise #merchant

  1. Navigate to Control panel > Access list.

  2. Click on the User email.

Note

You can use filters to easily find a user by user ID or email address. Also you can view users activity in your account by clicking the Sessions button (here you can view user’s email and the exact time and place of the login as well as some information about user’s device, like IP address and OS).

  1. Select the wallet to which you want to restrict access for the user.

  2. Change user role in the Change rights drop-down list or delete the user from your wallet by clicking the Remove button (note that the Owner cannot be removed). Ref. to User Roles for more information about user roles.

By clicking the Log button you can view the list of operations with the wallet filtered by the user email.

How to Create a Custom Token

#enterprise

Note

The information below is intended for Enterprise users only.

B2BinPay charges no commission for processing of custom tokens, but you have to pay for every custom token on a monthly basis — on the 1st of each month the payment is debited from the selected wallet. In case of non-payment, the token processing stops.

  1. Navigate to Control panel > Custom tokens.

  2. Click New custom token.

  3. Fill out the form:

  • Wallet — a wallet from which a monthly payment will be debited (can be changed after the token is created)

  • Token type — token blockchain

  • Contract — token ID in blockchain

  • Alpha — alpha-code assigned to the custom token

  1. Click Save.

To view the detailed information about the created custom token navigate to Control panel > Custom tokens and click on the Details.

After your custom token is created, you can create a wallet denominated in the token.

How to Create a Deposit

#enterprise

Note

The information below is intended for Enterprise users.

  1. Navigate to Deposits.

  2. Click Create new deposit.

  3. Fill out the form:

  • Wallet — required field: select the wallet

  1. If needed, set the Advanced options:

  • Label — the label of the deposit is displayed in the list and is used for quick search and can be any name convenient for you

  • Tracking ID — client-provided identifier to track the deposit in your system

  • Address type — select address type. You can select the duplicate type: if you have two wallets, one of which is the clone of another. You can also clone the deposit, created on the original wallet, to the clone wallet. This is possible after your wallet has been duplicated. If you selected the duplicate option:

    • add the list of deposits you want to duplicate

    • change the standard request URL to the duplicating one

Note

Note that you can duplicate the address only once, and only for ETH/BSC currencies.

  • Callback URL — URL to send notifications on new deposits. You can additionally specify the following templates in the URL callback — we will replace them with the corresponding values ​​automatically. This can be used for easier parsing of the callback body in your system (ref. to API documentation for details):

    • #PID# — payment identifier

    • #TRID# — tracking identifier

    • #WID# — wallet identifier

    • #TXID# — blockchain transaction identifier

    • #CISO# — currency code as per ISO

    • #CUR# — currency ALPHA code

    • #DID# — deposit identifier

  • Required block confirmations for callback — set required number of confirmations to receive an additional callback. If this field has a value, two callbacks will be sent: upon receiving the number of confirmations specified here and upon receiving the number of confirmations specified in the system settings

  1. Click Deposit.

Ref. to Deposits in the for more details.

How to Create an Invoice

#merchant

Note

The information below is intended for Merchant users.

  1. Navigate to Invoices.

  2. Click Create new invoice.

  3. Fill out the form:

  • Wallet — required field: select the wallet

  • Payment currency — select the payment currency or the Payer will choose currency by himself option — in this case payment currency will be selected by the payer

  1. If needed, set the Advanced options:

  • Label — the label of the invoice is displayed in the list and is used for quick search and can be any name convenient for you

  • Tracking ID — client-provided identifier to track the invoice in your system

  • Callback URL — URL to send notifications on new invoices. You can additionally specify the following templates in the URL callback — we will replace them with the corresponding values ​​automatically. This can be used for easier parsing of the callback body in your system (ref. to API documentation for details):

    • #PID# — payment identifier

    • #TRID# — tracking identifier

    • #WID# — wallet identifier

    • #TXID# — blockchain transaction identifier

    • #CISO# — currency code as per ISO

    • #CUR# — currency ALPHA code

    • #DID# — deposit identifier

  • Required block confirmations for callback — set required number of confirmations to receive an additional callback. If this field has a value, two callbacks will be sent: upon receiving the number of confirmations specified here and upon receiving the number of confirmations specified in the system settings

  1. Click Deposit.

Ref. to Invoices for more details.

How to Create a Payout

For Enterprise User

#enterprise

  1. Navigate to Payouts.

  2. Click Create new payout.

  3. Fill out the form:

  • Wallet — required field: select the wallet

  • Amount — required field: enter the payout amount, you can also add all the amount from your wallet by clicking All

  • Fee included — if active, fee will be included in the specified amount, the remaining part will be credited to the receiver’s account. If inactive, fee will be additionally debited from the wallet

  • Address — required field: paste the destination address. You can save the entered address to your address book by selecting Save to address book option. Next time you can just pick it from the list by clicking From address book

  • Fee modes — select the blockchain fee, speed of transaction processing depends on this amount: the lower the fee, the longer the transaction processing time. The following fee modes are available:

    • Low — economy mode when speed does not matter

    • Medium — optimum processing speed for a reasonable fee

    • High — priority transaction processing through high fees

    • Custom — here you can enter your own value. Note that your custom value cannot be two times lower than the Low value and three times higher than the High value.

  1. If needed, set the Advanced options:

  • Label — the label of the payout is displayed in the list and is used for quick search and can be any name convenient for you

  • Tracking ID — client-provided identifier to track the payment in external system

  • Callback URL — URL to send notifications on new deposits. You can additionally specify the following templates in the URL callback — we will replace them with the corresponding values ​​automatically. This can be used for easier parsing of the callback body in your system (ref. to API documentation for details):

    • #PID# — payment identifier

    • #TRID# — tracking identifier

    • #WID# — wallet identifier

    • #TXID# — blockchain transaction identifier

    • #CISO# — currency code as per ISO

    • #CUR# — currency ALPHA code

    • #DID# — deposit identifier

  • Required block confirmations for callback — set required number of confirmations to receive an additional callback. If this field has a value, two callbacks will be sent: upon receiving the number of confirmations specified here and upon receiving the number of confirmations specified in the system settings

Note

When creating a payout for some currencies, additional Tag and Tag type fields appear on the form.

  1. Click Save.

After clicking Save, a confirmation window with the payout details will appear. Check the information and click Yes to confirm your payout.

Ref. to Payouts for more details.

For Merchant User

#merchant

  1. Navigate to Payouts.

  2. Click Create new payout.

  3. Fill out the form:

  • Wallet — required field: select the wallet

  • Amount — required field: enter the payout amount, you can also add all the amount from your wallet by clicking All

  • Currency — required field: select currency from the drop-down list

  • Fee included — if active, fee will be included in the specified amount, the remaining part will be credited to the receiver’s account. If inactive, fee will be additionally debited from the wallet

  • Address — required field: paste the destination address. You can save the entered address to your address book by selecting Save to address book option. Next time you can just pick it from the list by clicking From address book

  • Fee modes — select the blockchain fee, speed of transaction processing depends on this amount: the lower the fee, the longer the transaction processing time. The following fee modes are available:

    • Low — economy mode when speed does not matter

    • Medium — optimum processing speed for a reasonable fee

    • High — priority transaction processing through high fees

    • Custom — here you can enter your own value. Note that your custom value cannot be two times lower than the Low value and three times higher than the High value.

  1. If needed, set the Advanced options:

  • Label — the label of the payout is displayed in the list and is used for quick search and can be any name convenient for you

  • Tracking ID — client-provided identifier to track the payment in external system

  • Callback URL — URL to send notifications on new deposits. You can additionally specify the following templates in the URL callback — we will replace them with the corresponding values ​​automatically. This can be used for easier parsing of the callback body in your system (ref. to API documentation for details):

    • #PID# — payment identifier

    • #TRID# — tracking identifier

    • #WID# — wallet identifier

    • #TXID# — blockchain transaction identifier

    • #CISO# — currency code as per ISO

    • #CUR# — currency ALPHA code

    • #DID# — deposit identifier

  • Required block confirmations for callback — set required number of confirmations to receive an additional callback. If this field has a value, two callbacks will be sent: upon receiving the number of confirmations specified here and upon receiving the number of confirmations specified in the system settings

Note

When creating a payout for some currencies, additional Tag and Tag type fields appear on the form.

  1. Click Save.

After clicking Save, a confirmation window with the payout details will appear. Check the information and click Yes to confirm your payout.

Ref. to Payouts for more details.

How to Create a Bank Withdrawal

#merchant

Note

The information below is intended for Merchant users.

To make a Bank Withdrawal you have to provide your account manager with your bank account requisites.

  1. Navigate to Payouts.

  2. Click Create a new bank withdrawal.

  3. Select the type of a bank withdrawal:

  • One-time withdrawal - a one-time withdrawal of the specified amount after the withdrawal creation

  • Regular withdrawal when the amount is reached — scheduled withdrawal of funds

  1. Fill out the form:

  • Requisite — type in the requisites of the bank account the funds will be credited to

  • Wallet — select the wallet, from which you want to withdraw funds

  • Amount — enter the amount to be withdrawn

  • Amount to be withdrawn — amount minus commission

If the bank withdrawal is a Regular withdrawal when the amount is reached select the amount type:

  • Fixed amount — if the specified amount is less than the amount of funds on the wallet, the withdrawal is performed

  • Changing amount — specify the following options:

    • Minimum non-reducible balance — minimum amount that must be left on the wallet after the withdrawal

    • Minimum withdrawal amount — minimum amount that can be withdrawn

  1. Click Save.

Ref. to Payouts for more details.

How to Create an Exchange

For Enterprise User

#enterprise

Note, that exchanges are available only for wallets with positive balance.

  1. Navigate to Exchanges.

  2. Click Create new exchange.

  3. Fill out the form:

  • Wallet (from) — select the debiting wallet

  • Wallet (to) — select the crediting wallet

  • Exchange rates — exchange rates will be displayed after selecting wallets. Note that rates have expiration time after which they will be updated

  • Amount (from) — enter the amount in the currency of debiting. You can also add all the amount from your wallet by toggling the Select all funds for exchange switch

  • Amount (to) — enter the amount in the currency of crediting

Note

Since wallets with 0 balances cannot be selected for the exchange, they are displayed at the end of the wallets list when filling out the Amount (from) and Amount (to) fields.

You can leave either the Amount (from) or Amount (to) field blank — the value will be calculated automatically based on the rates.

Note that the values in the Amount (from) and Amount (to) fields must be greater than or equal to the Minimal transfer amount set for receiver wallet (ref. to Wallet Settings for details).

  • Fee modes — select the blockchain fee. The speed of transaction processing depends on this amount: the lower the fee, the longer the transaction processing time. The following fee modes are available:

    • Low — economy mode when speed does not matter

    • Medium — optimum processing speed for a reasonable fee

    • High — priority transaction processing through high fees

    • Custom — here you can enter your own value

  1. Click Exchange.

After clicking Exchange a confirmation window with the exchange details will appear. Check the information and click Yes to confirm your exchange.

Note

Total amount (from) in confirmation form is given with blockchain fee included.

Ref. to Exchanges for more details.

For Merchant User

#merchant

Note, that exchanges are available only for wallets with positive balance.

  1. Navigate to Exchanges.

  2. Click Create new exchange.

  3. Fill out the form:

  • Wallet (from) — select the debiting wallet

  • Wallet (to) — select the crediting wallet

  • Exchange rates — exchange rates will be displayed after selecting wallets. Note that rates have expiration time after which they will be updated

  • Amount (from) — enter the amount in the currency of debiting. You can also add all the amount from your wallet by toggling the Select all funds for exchange switch

  • Amount (to) — enter the amount in the currency of crediting

Note

Since wallets with 0 balances cannot be selected for the exchange, they are displayed at the end of the wallets list when filling out the Amount (from) and Amount (to) fields.

You can leave either the Amount (from) or Amount (to) field blank — the value will be calculated automatically based on the rates.

Note that the values in the Amount (from) and Amount (to) fields must be greater than or equal to the Minimal transfer amount.

  1. Click Exchange.

After clicking Exchange a confirmation window with the exchange details will appear. Check the information and click Yes to confirm your exchange.

Ref. to Exchanges for more details.