Key terms
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 Blockchain fee and Commission 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
You can add your personal account of the AML provider as an additional level of verification. Find the step-by-step instruction here.
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.
Currently, two AML providers are available: Crystal and Chainalysis.
Bank withdrawal
This is a withdrawal of fiat funds from your Merchant wallet denominated in the same fiat currency to your bank account.
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
This is a blockchain commission for on-chain transactions.
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.
Refer also to Commission and Activation fee to learn about other commission types that can be charged.
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.
To receive callbacks, specify the Callback URL when creating a new deposit or payout via the Web interface, or when sending the Create deposit or Create payout requests via the API.
Callback types
The following callbacks can be sent for transactions:
Confirmation
The transfer has received a required number of block confirmations.
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.
You can use the Get currency method to receive the required number of confirmations configured for a currency.
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
The transfer has received a number of block confirmations specified by a client. See Additional callback below.
Manual
The callback is resent manually. See Resending callbacks below.
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.
The callback body depends on the callback type. For additional callback structure examples, see Deposit callback and Payout callback.
You can check that the callback was sent by B2BINPAY. Refer to Deposit callback verification and Payout callback verification for details.
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.
Refer also to Activation fee and Blockchain fee to learn about other commission types that can be charged.
Commissions for transaction processing
These are fees charged for handling transfers: deposits and payouts.
Their amount depends on:
Wallet type: Generally, B2BINPAY charges commissions for incoming transactions for Merchant wallets, and for outgoing transactions for Enterprise wallets. This approach is determined by the internal logic of the wallets and the B2BINPAY services involved in providing these wallets.
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.
Visit our website to view applicable commission rates.
Commissions for custom token processing
These are fees for maintaining of custom tokens. They're charged on a monthly basis from the parent wallet.
Commissions for Custody services
These are fees for storing funds on Custody wallets.
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.
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 block explorers to check if the transaction has received enough confirmations on the blockchain. You can find the required number of block confirmations for different currencies here.
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.
Custody wallets can be topped up from your Merchant and Enterprise wallets. Enterprise wallets must match the currency of the Custody wallet.
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.
Deposits can be made to your Enterprise or Merchant wallets. All the deposits to Enterprise wallets must match the wallet currency and are always on-chain. 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 off-chain. For the deposits to Merchant wallets, you can also specify various time and amount limits.
You can enable callback sending for any deposit to be notified about new deposit-related transactions.
Deposits shouldn't be confused with direct deposits.
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.
Direct deposits should not be confused with deposits.
Enterprise wallet
This is a B2BINPAY account enabling you to send, receive, and store funds in cryptocurrencies.
Enterprise wallets support transactions in the same currencies in which they're denominated. All transactions involving Enterprise wallets are on-chain.
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.
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 off-chain.
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. Payments below this minimum are automatically rejected to ensure economic viability, particularly when blockchain fee might exceed the transaction amount.
You can find information about minimum allowed deposits here. For Enterprise wallets, the Minimum transfer amount can be customized; for Merchant wallets, it's defined in the system settings.
Off-chain transaction
This is a transaction between Merchant wallets within B2BINPAY.
Such transactions aren't recorded on the blockchain, don't require blockchain confirmations, and therefore, don't incur blockchain fees. This method offers a cost-effective and rapid solution to transfer funds within the ecosystem.
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.
Such transactions are recorded on the blockchain, require blockchain confirmations, and therefore, incur blockchain fees.
All transactions involving Enterprise wallets 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.
Parent wallet
This is an Enterprise wallet to which a wallet denominated in tokens is linked.
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
This is a payment, withdrawal, or transfer made from your Enterprise or Merchant wallets.
All the payouts from Enterprise wallets must match the wallet currency and are always on-chain. The payouts from Merchant wallets can be made in any currency, payments to other B2BINPAY Merchant wallets can be off-chain.
For Merchant wallets denominated in fiat currencies, B2BINPAY also supports bank withdrawals.
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.
Along with the resources, you also receive 1 vote for each TRX staked. You can distribute the votes among SRs 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.
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
In TRX staking, 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.
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
This is a currency exchange operation between your Swap wallets.
Swap operations are always off-chain. You can exchange all available currencies, including fiat, coins, and tokens.
Swap wallet
This is a B2BINPAY account enabling you to swap 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 Enterprise or Merchant wallets, but you can transfer funds between your Swap and Enterprise/Merchant wallets denominated in the same currency.
Token
This is a digital asset that operates on an existing blockchain.
Unlike coins, 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.
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.
For more information on operation types, refer to Transfer types.
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.
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 block explorers.
User role
This is a set of permissions assigned to a user, enabling to perform certain actions in B2BINPAY. For more information, refer to User roles.
Wallet
This is an account of a B2BINPAY user.
B2BINPAY supports four wallet types for various purposes:
Last updated
Was this helpful?