Invoices
Manage cryptocurrency payment requests through invoices with unique deposit addresses and comprehensive tracking capabilities
An invoice is a request for cryptocurrency payments that generates a unique deposit address for receiving funds.
Funds received to this address must be claimed to the account address (smart contract).
Invoice list
On this page, you can view a list of all invoices created for your accounts.
The following information is provided about each invoice:
ID
The unique system identifier of an invoice. This is a link to invoice details.
This value is generated automatically and can't be modified.
Created at
The date and time when the invoice was created.
Updated at
The date and time of the most recent status change or payment receipt.
Currency
The payment currency or asset list.
If a single currency was selected, this field shows the asset symbol and name.
If more than one currencies were selected, this field shows the number of selected assets.
If no currency was specified, this field displays
—and payers can pay the invoice in any supported currency.
Requested amount
The amount to be paid in the selected currency.
If a single payment currency was specified, this field shows the requested amount.
If no currency or more than one currencies were specified, this field displays
—.
The value can be specified when creating an invoice and can be modified later.
Paid amount
The total amount paid so far, in the payment currency.
If more than one currencies were specified, this field displays the amount converted to the account base currency.
If no payments were received, this field displays
—.
Status
The current invoice status.
Possible values:
Created: The invoice was created and is awaiting payments.
Paid: The invoice with the indicated amount was paid in full (for invoices with indicated amount).
Unresolved: The amount of an incoming transfer is greater than the invoice amount (for invoices with indicated amount).
Tracking ID
The user‑provided identifier assigned to the invoice for easier locating related payments in external systems.
This value can be specified when creating an invoice and can be modified anytime.
Invoice details
To access invoice details, click an invoice ID in the invoice list.
In the upper part of the page, you can find essential information about the invoice — click the chevron icon to expand it:
The invoice identifier and current status.
The payment currency (if defined).
The requested amount (if specified).
The paid amount.
The created and updated timestamps.
The invoice address.
The link to the payment page.
The information below is divided into tabs.
On this tab, you can access and change invoice settings and advanced options.
If the currency was selected for the invoice, the following fields are available:
Currency
The payment currency associated with the invoice.
Status
The current invoice status.
Requested amount
The invoice amount, in the payment currency.
Tracking ID
The user‑provided identifier assigned to the invoice for easier locating related payments in external systems.
Can be changed anytime.
Callback URL
The URL for callback notifications on new payments and other invoice events.
Can be changed anytime.
Payment page URL
The link that is displayed as a button on the payment page.
Can be changed anytime.
Payment page button name
The custom name of a button displayed on the payment page.
Can be changed anytime.
On this tab, you can find a list of transfers associated with the invoice.
ID
The unique system identifier of a transfer. This is a link to transfer details.
Created at
The date and time when a transfer was received by B2BINPAY.
Status
The current status of a transfer.
Possible values:
Pending: The transaction has been detected by B2BINPAY DeFi and is currently in the queue for processing. The status will be changed soon.
Executed: The transaction has been mined to a block. The status will be changed soon.
Confirmed: The required number of block confirmations has been received and the transaction is completed. This is a final status.
Failed: The transaction has failed on the blockchain. This is a final status.
TXID
The blockchain transaction identifier, the same as the transaction hash. This is a link to the explorer.
Currency
The payment currency.
Amount
The transaction amount, in the payment currency.
Blockchain fee
The blockchain fee charged for this transfer, in the payment currency. The total fee reflects all claim attempts, including failed ones.
Confirmations
The current number of received confirmations on the blockchain.
Operation ID
For invoices and payouts: The unique operation identifier in the system. This is a link to operation details.
On this tab, you can view claim operations related to the invoice and trigger new claims.
At the top of the tab, a set of cards may show uncollected balances per network or currency, including:
Uncollected tx: The number of transactions that were deposited but not yet claimed.
Uncollected balance: The total amount available to claim for this currency.
Each card contains a Claim button that starts a claim flow for that asset.
On this tab, you can view a list of callbacks sent for the invoice.
Callback URL
The URL for callback notifications.
Type
The callback type.
Possible values:
INVOICE_CREATED: The invoice was created.INVOICE_DEPOSIT_RECEIVED: An incoming deposit transaction was detected on the invoice address.INVOICE_DEPOSIT_CONFIRMED: The incoming transaction has reached the required number of confirmations.INVOICE_PAID: The paid amount is equal the requested amount and the invoice status changes to Paid* (for invoices with indicated amount).INVOICE_UNRESOLVED: The paid amount is greater than the requested amount and the invoice status changes to Unresolved* (for invoices with indicated amount).INVOICE_CLAIMED: Funds from the invoice address have been claimed to the account multisig wallet.
Created at
The date and time the callback was sent.
Status
The callback sending status.
Possible values:
200 (success): The callback was delivered and acknowledged by the target endpoint.
3XX / 4XX / 5XX (failed): The callback was not accepted by the endpoint.
Common use cases
The Invoices page helps create payment requests, monitor their status, and claim collected funds. This section describes common scenarios step by step.
Create a new invoice
Create a new invoice and generate a payment page for your customers.
Go to Invoices in the main menu.
Click Create invoice in the upper‑right corner.
Fill in the Main details:
From the Payment currency dropdown, select the asset you want to receive or leave the field empty if the payer should be able to pay in any supported currency.
In the Amount field, optionally enter the amount to be paid in the selected currency. If you leave this field empty, the invoice will not enforce a specific amount.
Fill in the Advanced options:
In the Tracking ID field, optionally enter an invoice identifier to track the invoice-related transactions in external systems. It can be any combination of numbers and letters, chosen by you for ease of reference.
In the Callback URL field, optionally specify a URL for receiving callback notifications about invoice events.
In the Payment page URL field, provide the link that should be displayed as a button on the payment page.
In the Payment page button name, specify the custom name of a button displayed on the payment page.
Click Create.
The newly created invoice will appear in the list.
You can access and manage its settings anytime by clicking the invoice ID.
View invoice details
Track invoice-related transfers, callbacks, and claims.
Go to Invoices in the main menu.
In the invoice list, locate the required invoice and click its ID to open details.
Switch to the Transfers tab to see all payments associated with the invoice, including Status.
Switch to the Claims tab to review claim operations and their statuses or to see uncollected balances per currency.
Switch to the Callbacks tab to review callback history.
Claim funds
Claim funds that were deposited to the invoice address but not yet collected to the account.
Go to Invoices in the main menu and click the required invoice ID.
Switch to the Claims tab and locate cards with uncollected transactions and a non‑zero uncollected balance.
Click Claim on the card.
In the Sign claim popup, review the details, and click Sign.
Repeat for other claims.
After the claim is completed, it will disappear from the Claims tab. On the Transfers page, a new transfer with the Claim type will appear, providing full transaction information. Once the transfer is assigned the Executed status, funds will be credited to the account address.
You can also claim funds from the Claims page, including batch claiming of several transactions at a time.
Last updated
Was this helpful?