Merchant Guide

Wallets

Wallets are accounts nominated in crypto or fiat currency. We provide flexible options to customize your wallets and notifications.

Key points:

  • Wallet currency is specified when the wallet is created and cannot be changed.

  • Active wallets can be used to deposit and withdraw funds.

  • You can create any number of wallets.

  • You can provide access to the wallet to other users and limit this access using permissions.

Statuses of wallets

  • Not active — the wallet is available only in a Read Only mode.

  • In progress — the wallet is now being registered in the system and currently unavailable.

  • Active — the wallet has been activated and can be used to create deposits and payouts.

Wallets list

Filters

You can filter the list of your wallets by ID, Balance or Pending amount.

Each wallet in the wallets list contains the following information:

ID

The system identifier of the wallet, generated automatically when a wallet is created.

Label

The name of the wallet.

Currency

The wallet currency (for example, US Dollar or Bitcoin).

Balance

The available balance that can currently be used for payouts.

Pending

The sum of all incoming and outgoing transactions that have not yet received a confirmation. The value is positive for incoming transfers and negative for payouts. This balance cannot currently be used for transfers.

Exchange

Click this button to go to the Exchanges tab, where you can exchange currencies between your wallets.

Settings

Click this button to view the wallet details or change wallet settings, refer to Wallet settings for more details.

Wallet settings

To access Wallet settings, click the wallet ID or the Settings button on the wallets list page.

The Wallet settings include two tabs: Info and Log.

The Info tab contains all the essential wallet info:

Currency

The wallet currency. This value cannot be changed.

Label

The name of the wallet.

Site URL

URL address of your website.

The Advanced options section

Additional wallet settings. The section contains the following fields:

Notification addresses

A comma-separated list of email addresses to which new transaction notifications are sent.

Access Rights

In this section you can manage permissions for users who have access to the wallet (refer to How to Grant Access to Your Wallet, How to Restrict Access to Your Wallet for details). Here you can grant users access to a specific wallet. For more information about managing user access to all your wallets, refer to Managing access.

Log

The wallet history:

Created at

The date and time of an action.

Initiator

The field can have one of the following values:

  • System — system actions, such as wallet 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 wallet has been created.

  • Changed — the wallet has been changed.

  • Deleted — the wallet has been deleted.

Comment

The description of the action.

Old value

Previous state of the wallet.

Actual value

Current state of the wallet.

Transfers

Transfers are a summary of all payouts debited from your wallets and payments credited to your wallets.

Key points:

  • In this section you cannot create a new transfer. To create a new transfer, refer to Invoices or Payouts.

  • The list shows all transfers including cancelled, failed, and others.

Types of transfers

  • Wallet activation — amount necessary for the activation of the wallet.

  • Invoice — deposit.

  • Payout — payout.

  • Exchange charge — withdrawal of the exchange amount.

  • Exchange enroll — crediting of the exchange amount.

  • Wallet charge — customized withdrawal.

  • Transportation — amount charged for transportation of funds associated with a token payout.

  • Bank withdrawal — withdrawal of funds by means of Bank withdrawal.

Statuses of transfers

  • Cancelled — the transaction is cancelled due to security reasons or a transaction amount being to small.

  • Blocked — the transaction is rendered suspicious and temporarily blocked until further verification.

  • Failed — the transaction failed in the blockchain.

  • Created — the transaction has been created and is in the queue for processing, the status will be changed soon.

  • Unconfirmed — the transaction has not yet received the required number of block confirmations or the transaction legal status has not yet been verified.

  • Confirmed — the required number of block confirmations is received and the transaction is completed.

Transfers list

ID

The transaction identifier. This is a link to invoice or payout details (depending on the transfer type).

Created

The date and time of transaction creation or detection.

Type

Transaction purpose; refer to Types of transfers for more details.

Status

Current transfer status; refer to Statuses of transfers for more details.

TXID

The blockchain transaction identifier. This is a link to the explorer.

Currency

The transfer currency (including tokens).

Amount

Transaction total amount in sender’s currency.

Commission

Transaction processing fee in sender’s currency.

Blockchain fee

The blockchain commission for the transaction.

Confirmations

The current number of transaction confirmations in the blockchain.

Amount target

Transaction total amount in the wallet currency.

Rate

Transfer exchange rate for the moment of the transfer creation.

Commission target

Transaction processing fee in the wallet currency.

Operation ID

Link to the invoice or payout details (depending on the transfer type).

Transfer details

To access Transfer details, click the transfer ID on the transfers list page.

Each transfer has a tag right under the tarnsfer ID indicating the status of the AML verification of the transfer:

  • Checked — the transfer has passed AML check.

  • Pending — AML check is pending.

  • Failed — AML check failed, the transfer was marked as red.

  • Unavailable — AML check is unavailable for this transfer.

The transfer details page includes the following fields:

Wallet

The name of the wallet from/to which the transaction was made.

Type

Transaction purpose, refer to Types of transfers for more details.

Created

The date and time of transaction creation.

Updated

The date and time of transaction update (if any).

TXID

Blockchain transaction identifier. This is a link to the explorer.

Amount

Transaction amount in the sender’s currency.

Amount target

Transaction amount in the wallet currency.

Commission

Transaction commission in the sender’s currency.

Commission target

Transaction commission in the wallet currency.

Blockchain fee

Blockchain commission for the transaction.

Confirmations

The current number of transaction confirmations in the blockchain.

Rate

Current exchange rate; refer to Rates for more details.

Callback

Callback information. Possible values:

  • Not needed — the Confirmations needed field was not specified for an associated invoice or payout.

  • Sent — callback is sent.

  • Not sent — callback has not yet been sent (not enough confirmations received yet).

Currency

Transaction currency. May differ from the wallet currency.

Operation ID

Link to the invoice or payout details (depending on transfer type).

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.

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.

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 — funds are received in full.

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

  • Expired — payment time for the invoice with indication of time is expired.

  • Overpaid — amount charged for the invoice with indication of sum is more than specified.

  • Refund — payment amount is returned to the payer.

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.

Payment currency

The name of the payment currency.

Wallet

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

Paid in USD

The amount paid in the wallet currency.

Enrolled in

Paid amount minus commission.

Commission

Commission amount.

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.

Payouts

Payouts are withdrawals from your wallets. Payouts can be made in crypto or fiat currencies. Payout in fiat currency is called Bank withdrawal.

Key points:

  • Payout currency can differ from the wallet 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. You can choose the amount of fee when creating a payout.

  • Information about new transfers associated with a payout 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.

Payouts list

ID

The payout identifier. This is a link to the payout details.

Created

The date and time of payout creation.

Label

The payout name.

Wallet

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

Receiver

Destination address. This is a link to the explorer.

Status

The status of the payout. Possible values:

  • Waiting for approval — the payout is not yet approved.

  • Approved — the payout has been approved.

  • Cancelled — the payout has been cancelled.

Currency

The payout currency (including tokens).

Tracking ID

The identifier of the payment in the client system.

Amount

Payment amount in the wallet currency.

Commission

Payment commission.

Charged amount

The total withdrawn amount, which is calculated as follows: amount + commission + blockchain fee (if it is not included in the amount).

Updated

The date and time of payout update.

Payout details

To access Payout details, click the payout ID on the payouts list page.

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

The Info tab contains the essential payout info:

Wallet

The wallet from which funds are withdrawn.

Address

The wallet address of the receiver of the payment. This is a link to the explorer.

Currency

The payout currency.

Amount

The payout amount.

Charged

Total payout amount including commissions and fees.

Commission

Processing fee amount.

The Advanced options section

Additional payout settings. The section contains the following fields:

Label

The payout name.

Tracking ID

The identifier of the payment in your system.

Callback URL

URL for callback notifications on payouts. Such notifications may contain templates. To find out more about the templates, refer to How to Create a Payout if You are a Merchant User.

Required block confirmations for callback

Number of confirmations to receive an additional callback. If this field is not 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. Transactions IDs are links to transfers details (refer to Transfer details for more details).

The Log tab contains the payout history:

Created at

The date and time of an action.

Initiator

The field can have one of the following values:

  • System — system actions.

  • 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 payout has been created

  • Changed — the payout has been changed

  • Deleted — the payout has been deleted

Comment

The description of the action.

Old value

Previous state of the payout.

Actual value

Current state of the payout.

Events

Events feature a list of system notifications that require your actions.

Event types

  • Callback — resend callback that has not been sent by the system.

  • Payout approve — approve or cancel payouts created by users with the Withdrawals with approval role.

  • Transfer amount is less than required minimum — approve payouts below the minimal transfer amount.

  • Transfer to expired deposit — funds were sent to the expired invoice.

  • Overpaid deposit — the invoice with indication of sum is overpaid.

Note

Some actions can only be performed by users with the Owner and Admin roles.

Exchanges

Exchanges feature a list of currency transfers between your wallets nominated in different currencies.

Key points:

  • You can exchange currencies only between your own wallets.

  • Exchange operations can only be performed between wallets nominated in different currencies. To transfer currency between wallets nominated in the same currency, use Invoices.

  • When exchanging currencies, you can indicate the amount either in the debited currency or in the credited currency.

  • Exchange amount should be greater than or equal to the Minimal transfer amount.

Exchanges list

ID

An exchange operation identifier.

Status

Current status of the operation:

  • Created — the operation has been created and is in the queue for processing. The status will be changed soon.

  • Failed — the operation failed in blockchain.

  • Success — the operation was successfully completed.

  • Pending — the operation is now being processed.

Wallet (from)

Debiting wallet.

Amount (from)

Amount in the currency of a debiting wallet (blockchain fees not included).

Wallet (to)

Crediting wallet.

Amount (to)

Amount in the currency of a crediting wallet.

Created

The date and time of exchange creation.

Exchange details

To access Exchange details, click the operation ID on the exchanges list page.

Wallet (from)

Debiting wallet.

Wallet (to)

Crediting wallet.

Exchange rate

Exchange rates (refer to Rates for more details).

Amount (from)

Amount in the currency of a debiting wallet (blockchain fees not included).

Amount (to)

Amount in the currency of a crediting wallet.

Applicant

Email address of the user who created the exchange operation.

Created

The date and time of exchange creation.

Transactions

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

Rates

Rates are the current exchange rates for any currency conversion. These rates are used for exchange operations between your wallets.