Invoices

Invoices are bills with indication of a sum and payment address which you render to payers. The invoice currency may differ from the wallet currency — a payer can specify any currency for the invoice.

Key points

  • The system accepts payments in crypto currency and allows you to enroll and withdraw funds in fiat currency.

  • Each transaction requires a certain number of confirmations in the blockchain.

  • The processing speed of a transaction in the blockchain depends on the blockchain fee amount.

  • Information about new transfers associated with an invoice can be sent to your system via a callback.

  • Each transaction can be assigned a special identifier by which the transaction can be tracked in your system.

  • It is possible to generate a payment page in order to send payment details to your payers.

  • It is possible to set time limits to specify the expiration time for the invoice as well as payment limits to hedge possible payment amount variations due to rate changes.

Types of invoices

  • With no sum and no time indication — this type of invoice has no indication of sum and expiration time.

  • With indication of sum and time — this type of invoice contains information about the sum and time of the operation. A receiver of such invoice can recalculate the sum of the invoice according to the current rates by clicking the Recalculate button.

  • With indication of time limit — this type of invoice contains information about the expiration time and no indication of sum.

  • With indication of sum limit — this type of invoice contains information about the payment amount and no indication of the expiration time.

Invoices list

ID

The invoice identifier. This is a link to the invoice detailed information.

Created

The date and time of invoice creation.

Wallet

Name of the wallet to which funds are credited. This is a link to the wallet details.

Address

Payment address of the invoice in the blockchain. This is a link to the explorer.

Currency

Payment currency (including tokens).

Tracking ID

Identifier of the payment in the client system.

Status

Status of the invoice. Possible values:

  • Invoice — the invoice has just been created, or funds are not received in full if there were invoice amount limits.

  • Paid — the invoice with indication of sum is paid in full.

  • Cancelled — the invoice is cancelled by a user.

  • Unresolved — the invoice needs actions from the user (for example, if the payment is received after the specified expiration date, the status of such invoice cannot be changed automatically and the invoice needs actions from the user). Navigate to Invoice details to change the invoice status manually.

Requested amount

The requested amount in the wallet currency.

Requested rate

The rate that is up to date when an invoice is created. This rate is updated in 15 minutes after the invoice creation.

Paid amount

Amount of funds sent by a payer.

Enrolled amount

Amount received by the client. This is a paid amount minus the commission.

Commission

Invoice commission.

Expired at

The date and time of the expiration of the invoice with indication of time. If the invoice has no time indication, the field is blank.

Invoice details

To access Invoice details, click the invoice ID on the invoices list page.

The Invoice details page includes two tabs: Info and Log.

The Info tab contains the essential invoice information:

Address

Payment address of the invoice in the blockchain. This is a link to the explorer, this field cannot be edited.

View payment page button

Click this button to view the payment page. If the payment currency was selected when creating the invoice, you can view the QR code that contains the address of your deposit. You can use any QR-code generator library to create a QR code. If the payment currency was not selected, you can see a list of available payment currencies on the payment page. Select the desired payment currency to generate the QR-code.

Payment currency

The name of the payment currency.

Estimated amount payable

The amount in the payment currency (if the payment currency was specified). The value is updated along with the requested rate value.

Wallet

The name of the wallet, to which the funds were credited.

Requested amount

The requested payment amount in wallet currency.

Paid in

The amount paid in the wallet currency.

Enrolled in

Paid amount minus commission.

Commission

Commission amount.

Limits

The payment limits and expiration time of the invoice.

Change status

The current status of the invoice. To change the status, click it and select the desired status.

Limits

The payment limits and expiration time of the invoice.

Delta

Set this value to hedge possible rate changes during the expiration time of your invoice. You can change this value any time. For more information about delta, see How to create an invoice.

Change status

The current status of the invoice. To change the status, click it and select the desired status.

The Advanced options section

Additional invoice settings. The section contains the following fields:

Label

The invoice name.

Tracking ID

The identifier of the payment in the client system.

Callback URL

URL for callback notifications on invoices. Such notifications may contain templates. To find out more about the templates, refer to How to create an invoice.

Required block confirmations for callback

Number of confirmations to receive an additional callback. If this field is nor blank, two callbacks are sent: upon receiving the number of confirmations specified here and upon receiving the number of confirmations specified in the system settings.

The Transactions section

A list of transactions. Transaction IDs are links to transfers details (refer to Transfer details for more details).

The Log tab contains the invoice history:

Created at

The date and time of an action.

Initiator

The field can have the one of the following values:

  • System — system actions, such as invoice creation or status change.

  • API — actions performed via the system API.

  • Email address — actions performed by a specific user via the system user interface.

Reason

A particular reason for the action. The field can have the following values:

  • Created — the invoice has been created

  • Changed — the invoice has been changed

  • Deleted — the invoice has been deleted

Comment

The description of the action.

Old value

Previous state of the invoice.

Actual value

Current state of the invoice.