LogoLogo
Release notesTry demo
  • Welcome to B2BINPAY docs
  • Get started
    • Sign up and sign in
    • Explore the Web interface
    • Create a wallet
    • Configure security settings and access permissions
    • Set up integrations
    • Use Helpdesk to get assistance
  • User guide
    • Wallet management
      • Wallets
      • Transfers
      • Deposits
      • Payouts
      • Events
      • Callbacks
    • Custody
      • Wallets
      • Requests
      • History
    • Staking
      • TRX staking
    • Rates
    • Swaps
      • Wallets
      • Swap
      • History
  • How-tos
    • Manage your profile and system
      • How to sign up
      • How to change your password
      • How to enable 2FA
      • How to whitelist IP addresses
      • How to access the API
      • How to enable additional AML check
    • Manage your wallets
      • How to create a wallet
      • How to grant access to your wallet
      • How to manage user roles
      • How to restrict access to your wallet
      • How to generate a report on wallet balances
      • How to set withdrawal thresholds
    • Manage your assets
      • How to create a deposit
      • How to create a payout
      • How to create a bank withdrawal
      • How to create an internal transfer
      • How to select the optimal blockchain fee
      • How to speed up your payout by changing the blockchain fee
      • How to whitelist a payout address
      • How to swap funds
      • How to top up or withdraw funds from your Custody wallet
  • API guide
    • API overview
    • Authentication
    • Wallet methods
    • Transfer methods
    • Deposit methods
    • Payout methods
    • Currency methods
    • Rate methods
  • References
    • Key terms
    • User roles
    • Transfer types
    • Currency codes
    • Block explorer list
    • Address types
    • Useful links
  • Troubleshooting
    • Error: No active account found with the given credentials
    • Error: Invalid 2FA code
    • Error: You IP is not whitelisted
    • Unresolved deposits
    • Missing deposits
    • Canceled transfers
    • Unconfirmed transfers
  • Release notes
Powered by GitBook
On this page
  • 2FA
  • Activation fee
  • AML
  • Default AML check
  • Additional AML check
  • Bank withdrawal
  • Blockchain fee
  • Callback
  • Callback types
  • Additional callback
  • Callback processing
  • Resending callbacks
  • Coin
  • Commission
  • Commissions for transaction processing
  • Commissions for custom token processing
  • Commissions for Custody services
  • Confirmation block
  • Custody wallet
  • Custom token
  • Deposit
  • Destination tag
  • Direct deposit
  • Enterprise wallet
  • KYC
  • Merchant wallet
  • Minimum transfer amount
  • Off-chain transaction
  • On-chain transaction
  • Parent wallet
  • Payout
  • Stablecoin
  • Staking
  • SR
  • Swap
  • Swap wallet
  • Token
  • Tracking ID
  • Transfer
  • TXID
  • User role
  • Wallet

Was this helpful?

  1. References

Key terms

PreviousRate methodsNextUser roles

Last updated 2 months ago

Was this helpful?

2FA

The Two-Factor Authentication is an additional method of authentication that adds one more layer of security to your account. It assumes that, when signing in, in addition to your credentials, you also enter a unique one-time and time-limited confirmation code.

B2BINPAY provides 2FA with the Google Authenticator app (it's free).

We strongly recommend that you and all the members of your team enable 2FA as it's an essential means of protecting your finances. Additionally, certain system features require 2FA enabled.


Activation fee

This is a deposit that you have to make to your wallets denominated in specific currencies in order to activate them.

After the wallet that require confirmation is created, you'll receive a message on the Notifications page indicating the required deposit amount. Once deposited, the fee amount is frozen on the wallet and the wallet is assigned the Active status. You can use your Merchant wallets to deposit the required amount of funds.

Refer also to and to learn about other commission types.


AML

Anti-Money Laundering is certain regulations and laws that prevent illegal movement and laundering of funds.

Default AML check

B2BINPAY provides a built-in obligatory AML check for all incoming transfers. The check is performed on the side of a connected AML provider.

During AML verification, the incoming transfer amount is displayed in the wallet as Pending and can't be used for financial operations. If the check is successful, the incoming transfer amount is enrolled to the wallet balance.

If a transaction is considered suspicious, it's assigned the Blocked status and is subject to further actions by the B2BINPAY Compliance department.

Additional AML check

If enabled, after successfully passing the default AML check, the transfer is sent to your provider for additional verification. During the entire duration of both checks, the amount of the incoming transfer remains in Pending.


Bank withdrawal

B2BINPAY provides three types of bank withdrawals:

  • One-time withdrawal: A single withdrawal of a fixed amount.

  • Regular withdrawal with a fixed amount: A withdrawal that is triggered every time when the wallet balance reaches the specified amount plus the commission amount.

  • Regular withdrawal with a changing amount: A withdrawal where you additionally specify the minimum amount that should be left on your wallet after the withdrawal. This withdrawal is triggered every time when the wallet balance reaches the amount calculated as Withdrawal amount + Leftover amount + B2BINPAY commission amount.

To enable bank withdrawals, submit your banking details in advance to your B2BINPAY manager.


Blockchain fee

These fees are essential for the network's operation, as they compensate miners or validators who secure and maintain the blockchain. Each network dictates its own fee structure, which can vary based on network traffic. During peak times, fees may rise due to increased demand for transaction processing.

When sending funds, you can select from possible blockchain fee levels: low, medium, high, or custom. A higher fee typically results in faster processing. These values are pre-calculated by B2BINPAY at the moment of payout creation based on the current blockchain fee records.


Callback

This is an asynchronous notification about changing statuses of deposits and payouts, sent by B2BINPAY to your server. You can use callbacks to make changes in your system and notify your payers, or just track the transactions.

To handle incoming POST-requests from a callback URL in your application:

  • Define a route, such as /payment/callback.

  • Create an endpoint to process incoming data, such as validating transactions and updating your database accordingly.


Callback types

The following callbacks can be sent for transactions:

Confirmation

This number is determined in the currency settings in the B2BINPAY Back Office. For example, the required number of confirmations for a currency is set to 3. It means that this callback will be sent after receiving three confirmations.

Fail

The transfer failed.

No transfer

The deposit has expired or the payout wasn't approved, no transfer was created.

Block

The deposit was blocked by an AML provider, the transfer was canceled.

Cancel

The payout was blocked by an AML provider, the transfer was canceled.

User confirmation

Manual

Additional callback

By default, a callback is sent after a transaction achieves a specified number of block confirmations on the blockchain. This number is determined in the currency settings in the B2BINPAY Back Office.

To trigger an additional callback, you can set a different number of confirmations when creating a deposit or payout via the Web UI or API.

For example:

  • Default confirmation requirement: 3 blocks

  • Specified for a particular deposit or payout: 1 block

In this case, the callback will be sent twice: after 1 confirmation and again after 3 confirmations.

Callback processing

The callback is sent to your server if the deposit/payout includes a valid callback URL. The callback is sent as a POST-request, which contains useful JSON payload.

After processing the payload, your server should respond with the HTTP 200 response code without a body.

Resending callbacks

If your server is temporarily unavailable or the status of the response is different from 200, the system will resend the callback several times with the increasing delay time. The number of re-sendings is limited.

If the manual resending is required, you can do it on the Wallet management > Events page in the Web UI.


Coin

This is a cryptocurrency that operates independently in its own blockchain.

Coins act as native currencies within their specific financial systems and can only be transferred between participants in their respective networks.

Key points:

  • Operate on their own independent blockchain.

  • Can be mined or earned through validation activities like staking or proof-of-work.

  • Serve as native currencies within their blockchain ecosystem.

  • Used primarily for transactions, payments, and storing value.

Example:

  • TRX: The Tron coin operating on the Tron blockchain that can be transferred between participants within the Tron network.


Commission

This is a commission charged by B2BINPAY for its services. Detailed descriptions of each commission type are provided below.

Commissions for transaction processing

These are fees charged for handling transfers: deposits and payouts.

Their amount depends on:

  • Transaction currency: Different cryptocurrencies have different commission rates applied.

  • Overall transaction volume: Generally, higher transaction volumes are rewarded with lower commission rates. Once you reach a designated threshold, the applicable commission rate is fixed for the rest of the month. Note that previously charged commissions aren't recalculated.

Commissions for custom token processing

Commissions for Custody services

The accumulated commission is calculated daily, based on the tier percentage of stored funds. The commission is charged on the first of each month and with each withdrawal from the Custody wallet.


Confirmation block

This is a process of transaction confirmation on the blockchain. A transaction is being verified on the blockchain and the blocks are added to the transaction thus confirming it.


Custody wallet

This is an account designed for secure storage, available only to users with the Owner role and requiring video verification for withdrawal of funds.

Withdrawals form Custody wallets can be made to Merchant and Enterprise wallets denominated in the same currency, as well as to external addresses.

B2BINPAY charges commissions for storing funds on Custody wallets, their amount is calculated based on the tier percentage of stored funds. You can find information about applied tiers on the Custody > Wallets page.

The accumulated commission is calculated daily for each Custody wallet. The commission is charged monthly and with every withdrawal from the Custody wallet.


Custom token

This is a token created by a B2BINPAY user on the Ethereum, Binance Smart Chain, or Tron blockchains.

B2BINPAY charges a fixed commission for custom token processing, which is applied on a monthly basis.

Currently, new custom tokens can't be created. Existing custom tokens continue to be supported.


Deposit

This is an invoice that you create in B2BINPAY to receive payments from other people.


Destination tag

This is a special identifier used for transactions in XRP. It's used to indicate the recipient of the payment. The absence of the destination tag or incorrect destination tag results in payment rejection or irreversible loss of funds.

The destination tag for Stellar-based currencies (memo) can be applied both to deposits and withdrawals. You can indicate the following memo types:

  • MEMO_TEXT: A string encoded using either ASCII or UTF-8; maximum length is 28 bytes.

  • MEMO_ID: A 64-bit unsigned integer.


Direct deposit

This is a crediting of funds to your own wallet.


Enterprise wallet

This is a B2BINPAY account enabling you to send, receive, and store funds in cryptocurrencies.


KYC

The Know Your Customer or Know Your Client are standards for financial institutions obliging them to verify a client's identity before carrying out financial transactions. The aim of KYC is to better understand the clientele, monitor financial transactions, reduce client risks, and prevent bribery and corruption.

B2BINPAY provides a built-in obligatory KYC check of all new clients. After signing up for B2BINPAY, you'll be asked to provide certain information and documents verifying your identity to complete the KYC procedure.


Merchant wallet

This is a B2BINPAY account enabling you to send, receive, and store funds either in fiat or in cryptocurrencies.


Minimum transfer amount

This is a threshold set for incoming transfers to a wallet, that is, the minimum deposit amount that can be made to your wallet.


Off-chain transaction

However, for payouts made from Merchant wallets, you can enable the force_blockchain setting to forcibly process the transaction on-chain, if it's important for your business and compliance processes. This setting is available when creating a payout via the API.


On-chain transaction

This is a transaction processed on the blockchain.


Parent wallet

The parent wallet must be created in the same blockchain as the token. Each parent wallet can serve as the parent for a single token wallet, it's not possible to link two token wallets to the same parent wallet.

The B2BINPAY commission for token processing is charged from the parent wallet. Therefore it's important to maintain the minimum required amount of funds on the wallet to process transactions. The required amounts are as follows:

  • 75 TRX (Tron)

  • 0.0009 BNB (Binance Smart Chain)

  • 0.01 ETH to 0.05 ETH (Ethereum)


Payout


Stablecoin

This is a cryptocurrency, the market value of which is pegged to a reference asset, such as fiat currency, precious metal, and so on.

Stablecoins combine the efficiency and security of blockchain technology with the stability of traditional finance, making them attractive for trading, savings, or payments.

Key points:

  • Bridge digital assets with the traditional financial ecosystem.

  • While aren't guaranteed to maintain complete stability, they tend to be less volatile than popular cryptocurrencies.

  • Based on the "underlying" asset, can be categorized into various types, such as fiat-collateralized, crypto-collateralized, commodity-collateralized, algorithmic.

Example:

  • USDT: The Tether stablecoin backed by the U.S. dollar at 1:1 ratio.


Staking

Staking is a process of locking up crypto assets for a certain period of time to support the operation of the blockchain. In exchange for staking your crypto, you earn more crypto and/or save on commissions.

At the moment, B2BINPAY supports TRX staking. You can stake TRX in exchange for resources: bandwidth or energy. The resources allow you to save on the blockchain fee. Bandwidth is spent on TRX transfers and TRC-10 tokens, as well as partially on interacting with smart contracts. Energy is spent on interacting with smart contracts and transferring TRC-20 tokens. The resources are replenished throughout the day.

You can unstake your funds anytime, but remember that the unstaking process takes 14 days on the blockchain. So you'll be able to withdraw TRX to your wallet after 14 days, until then they remain locked. You can cancel the unstaking request anytime during this period. When unstaking, all distributed votes are automatically canceled, the resources are no longer available.


SR

When deciding on which SR to vote for, you can rely on the following key performance indicators displayed by B2BINPAY for each SR:

  • Current votes: The total number of votes cast for the SR.

  • Reward distribution: The proportion of rewards distributed to voters to all rewards gained by the SR.

  • Productivity: The percentage of successfully validated blocks.

  • Expected APR: The expected annual percentage rate. The APR may change at any time and the estimated profit may differ from the actual profit received.

Mind that reward distribution is up to the SR and can't be guaranteed by B2BINPAY.

The process is divided into rounds. You can gain profit for each round. The accumulated reward can be claimed and withdrawn to your TRX wallet once in 24 hours, with a 10% commission is deducted from the reward. You can re-distribute your votes to SRs at any time, this will take effect from the next round.

The list of 27 SRs available for voting is provided by the Tron blockchain and is valid for a certain period of time. After that, a redistribution of positions in the list may occur. Keep in mind that if an SR is no longer ranked in the top 27, they can no longer generate and distribute rewards. The votes given to such SRs aren't automatically canceled, if you want to recall your votes, you have to do it manually.


Swap


Swap wallet


Token

This is a digital asset that operates on an existing blockchain.

Key points:

  • Issued on top of existing blockchains.

  • Non-mineable and created through smart contracts.

  • Represent assets, utilities, or rights within a particular project.

  • Offer a wider range of functionalities compared to coins.

Example:

  • USDT-TRX: The Tether (USDT) token issued on the Tron blockchain that can be used within the Tron network.


Tracking ID

This is a unique identifier that you can assign to your deposits and payouts. Its primary purpose is to help identify specific transactions in B2BINPAY and external systems.

This identifier can be composed of any combination of numbers and letters, chosen by you for ease of reference. For each payout, the Tracking ID must be unique within the wallet, whereas you can reuse the same identifier across multiple deposits.

The Tracking ID can be specified when creating deposits and payouts via both the Web UI and API, and can be utilized in callbacks sent by the system. It helps both businesses and customers track transactions and quickly locate and address issues in case of any discrepancies.


Transfer

This is any crediting or debiting of funds registered on the wallet.


TXID

This is a transaction identifier, or transaction hash, which is a unique identifier assigned to each blockchain transaction.

It stores transaction details, such as the sender's and receiver's addresses, amount, and time, all encrypted into a unique alphanumeric string. The example of a TXID: f4184fc596403b9d638783cf57adfe4c75c605f6356fbc91338530e9831e9e1.


User role


Wallet

This is an account of a B2BINPAY user.

B2BINPAY supports four wallet types for various purposes:

You can add your personal account of the AML provider as an additional level of verification. Find the step-by-step instruction .

Currently, two AML providers are available: and .

This is a withdrawal of fiat funds from your denominated in the same fiat currency to your bank account.

This is a blockchain commission for .

Refer also to and to learn about other commission types that can be charged.

To receive callbacks, specify the Callback URL when creating a new or via the Web interface, or when sending the or requests via the API.

The transfer has received a required number of .

You can use the method to receive the required number of confirmations configured for a currency.

The transfer has received a number of block confirmations specified by a client. See below.

The callback is resent manually. See below.

The callback body depends on the callback type. For additional callback structure examples, see and .

You can check that the callback was sent by B2BINPAY. Refer to and for details.

Refer also to and to learn about other commission types that can be charged.

Wallet type: Generally, B2BINPAY charges commissions for incoming transactions for , and for outgoing transactions for . This approach is determined by the internal logic of the wallets and the B2BINPAY services involved in providing these wallets.

Visit to view applicable commission rates.

These are fees for maintaining of . They're charged on a monthly basis from the parent wallet.

These are fees for storing funds on .

Until the required amount of blocks is received, the corresponding transfer in B2BINPAY is assigned the Unconfirmed status. The confirmation time may vary based on the blockchain used, fees paid, and network load. Use to check if the transaction has received enough confirmations on the blockchain. You can find the required number of block confirmations for different currencies .

Custody wallets can be topped up from your and wallets. Enterprise wallets must match the currency of the Custody wallet.

Deposits can be made to your or wallets. All the deposits to Enterprise wallets must match the wallet currency and are always . The deposits to Merchant wallets can be made in any currency, including the option when payers select the payment currency themselves. Payments from other B2BINPAY Merchant wallets can be . For the deposits to Merchant wallets, you can also specify various time and amount limits.

You can enable sending for any deposit to be notified about new deposit-related transactions.

Deposits shouldn't be confused with .

Direct deposits should not be confused with .

Enterprise wallets support transactions in the same currencies in which they're denominated. All transactions involving Enterprise wallets are .

Merchant wallets support transactions in various currencies that may differ from the currency in which the wallet is denominated. Transactions between B2BINPAY Merchant wallets can be .

Payments below this minimum are automatically rejected to ensure economic viability, particularly when might exceed the transaction amount.

You can find information about minimum allowed deposits . For Enterprise wallets, the Minimum transfer amount can be customized; for Merchant wallets, it's defined in the system settings.

This is a transaction between within B2BINPAY.

Such transactions aren't recorded on the blockchain, don't require , and therefore, don't incur . This method offers a cost-effective and rapid solution to transfer funds within the ecosystem.

Such transactions are recorded on the blockchain, require , and therefore, incur .

All transactions involving are always on-chain. For payouts made from Merchant wallets, you can enable the force_blockchain setting to forcibly process the transaction on-chain, if it's important for your business and compliance processes. This setting is available when creating a payout via the API.

This is an to which a wallet denominated in is linked.

This is a payment, withdrawal, or transfer made from your or wallets.

All the payouts from Enterprise wallets must match the wallet currency and are always . The payouts from Merchant wallets can be made in any currency, payments to other B2BINPAY Merchant wallets can be .

For Merchant wallets denominated in fiat currencies, B2BINPAY also supports .

Along with the resources, you also receive 1 vote for each TRX staked. You can distribute the votes among and gain additional profit in return: the process is split into rounds, during which SRs generate profit that they can further distribute as rewards among their voters. Mind that reward distribution is up to the SR and can't be guaranteed by B2BINPAY. Once in 24 hours the accumulated reward can be claimed and withdrawn to your TRX wallet, with a 10% commission is deducted from the reward. You can re-distribute your votes at any time, this will take effect from the next round. The resources and votes are available immediately after staking.

In , this is a Super Representative to whom you may give your votes. They serve as blockchain "partners", supporting its operation and generating profit, which they can further distribute as rewards among their voters.

This is a currency exchange operation between your .

Swap operations are always . You can exchange all available currencies, including fiat, coins, and tokens.

This is a Coinsbuy account enabling you to currencies.

Swap wallets can be denominated either in crypto or in fiat currencies, but you can only create one wallet per currency. Swap wallets aren't linked to your or wallets, but you can transfer funds between your Swap and Enterprise/Merchant wallets denominated in the same currency.

Unlike , which have their own blockchains, tokens are issued on established third-party blockchains, such as Ethereum, Tron, or BNB Smart Chain. Companies often issue tokens during Initial Coin Offerings (ICOs) or other token sale events. Tokens can represent assets, utilities, or even voting rights within a specific project.

For more information on operation types, refer to .

B2BINPAY logs TXIDs for all transactions registered in the system. You can find them on the Transfers page and in Transactions tabs of deposit and payout details. Each TXID links to a blockchain explorer — a public tool for tracking transactions. In this documentation, you can also find a list of .

This is a set of permissions assigned to a user, enabling to perform certain actions in B2BINPAY. For more information, refer to .

Blockchain fee
Commission
here
Crystal
Chainalysis
Merchant wallet
on-chain transactions
Commission
Activation fee
deposit
payout
Create deposit
Create payout
block confirmations
Get currency
Additional callback
Resending callbacks
Deposit callback
Payout callback
Deposit callback verification
Payout callback verification
Activation fee
Blockchain fee
Merchant wallets
Enterprise wallets
our website
custom tokens
Custody wallets
block explorers
here
Merchant
Enterprise
Enterprise
Merchant
on-chain
off-chain
callback
direct deposits
deposits
on-chain
off-chain
blockchain fee
here
Merchant wallets
blockchain confirmations
blockchain fees
blockchain confirmations
blockchain fees
Enterprise wallets
Enterprise wallet
tokens
Enterprise
Merchant
on-chain
off-chain
bank withdrawals
SRs
TRX staking
Swap wallets
off-chain
swap
Enterprise
Merchant
coins
Transfer types
block explorers
User roles
Enterprise wallet
Merchant wallet
Swap wallet
Custody wallet