API Documentation
English
English
  • Authorization
  • Request signing
  • List of error codes
  • Webhooks
  • IFrame order
  • Payment acceptance widget
  • Telegram MiniApp
  • API Reference
    • Base actions
      • Check x-api-signature
      • Fetch available currencies
      • Current price request
      • Search for operations by TX hash
      • Check address format
      • Get transaction history
    • Advanced account
      • Get advanced balances of user
      • Get advanced balance by id
      • Get payment address for advanced balance top-up
    • Blockchain addresses
      • Search by id
      • Transactions tracking
      • Search by address
      • Meta-data
      • Address Transactions
      • Last transaction of the address
      • Getting a list of PayIn addresses
      • Getting a list of business addresses
      • Get recurrent addresses
      • Getting a list of PayOut addresses
      • Creating a new business wallet address
      • Creating a new PayOut wallet address
    • Personal addresses
      • User creation
      • Getting an address
      • Getting a list of addresses
      • Get user
      • Adding a trusted address
      • Getting a list of trusted addresses
      • Deleting a trusted address
    • Orders
      • Creating an order
      • Getting information about an order
      • Getting a list of orders
    • Withdraws
      • Getting a commission for making a withdrawal
      • Sync withdraw
      • Async withdrawal
      • Receiving withdrawal information
    • Invoices
      • Create an invoice for payment
      • Invoice information request
      • Getting a list of invoices
    • Auto swaps
      • Create auto-swap
      • Find auto-swap by ID
    • Withdrawals 2.0
      • Create auto-withdrawal
      • Find auto-withdrawal by ID
      • Additional confirmation of the withdrawal
    • Bridge
      • Getting limits for cross-chain transfer
      • Getting information about cross-chain transfer
      • Commission token formation
      • Creating a cross-chain translation
    • Swaps
      • Getting limits for cross-chain exchange
      • Getting information about cross-chain exchange
      • Commission token formation
      • Creation of a cross-chain exchange
    • Recurring payments
      • Creating a payment link
      • Get a payment link
      • Get payment links by user
      • Disabling the payment link
      • Create a subscription
      • Getting a subscription
      • Cancel Subscription
      • Creating a payment
    • KYT
      • Check transaction risks
      • Check withdrawal risks
      • Check withdrawal risks for provided address
    • Partners API
      • Create user
      • Get user
      • Get all users
      • Creating an organization
      • Getting a list of organizations
      • Getting the user's advance balances
      • Replenishment of the user's advance balance
      • Get general tariffs
      • Create/update individual tariff
      • Get individual tariffs
      • Create API key
      • Get API keys
      • Delete API key
    • Webhooks
      • Get webhook
      • Get webhook (extended)
    • Orphan transactions
      • Get a transaction
      • Get a list of transactions
      • Get a commission token
      • Withdrawal
    • Address book
      • Add an address
      • Delete an address
      • Update the address
      • Get a list of addresses
Powered by GitBook
On this page
  • Possible statuses
  • Invoice lifetime
  1. API Reference

Invoices

This section describes methods for creating invoices and obtaining information about invoices.

The functionality of the accounts allows you to accept payment in the specified equivalent, and the coin and network are chosen by the payer

For example, you can create an invoice for payment of 100 USD, the payer will be asked to select coin and network in which it will be more convenient for him to pay, for example, in USDT, TRX, BNB and others. The amount due will be recalculated automatically at the exchange rate.

When paying, you can also additionally indicate the percentage to be paid (field insurancePercent), in this case, the payer will be shown the amount to be paid as 100 USD, but the payment amount, for example, in USDT will be equal <AMOUNT TO PAY> * <USDT/USD RATE> + <insurancePercent> Example: you created an invoice for payment of 75 USD and specified insurancePercent equal to 5. When choosing a payment coin, for example, USDT (we will assume that the USDT/USD rate is 1=1), the payer will be asked to pay 78.75 USDT (5% of 75 = 3.75)

You can also specify that the payer pays the network commission by specifying the includeFee: true parameter. In this case, the commission chosen by the payer will be added to the final payment amount.

It is possible to specify the percentage of price slippage (field slippagePercent). If it is indicated, then if the payer, when paying, sends an amount more or less than the payment amount by the specified percentage, then the account will be considered closed. Example: the payer needs to pay 100 USDT, you specified a slippage percentage of 0.5%. In this case, if the payer sends the amount of 99.99 USDT (from 99.5 to 100.5), the invoice will be considered completed

Possible statuses

Status
Description

INIT

The user proceeded to payment

ERROR

Error during creation or processing

PROCESSED

Executed

PENDING

Waiting for the full amount or waiting for transaction confirmations in the blockchain

EXPIRED

Invoice expired

PARTIAL

Partial payment

OVERPAID

The invoice was paid in excess of the stated amount

REJECTED

Invoice rejected, contact support for clarification

When the status changes or a new transaction arrives, you will be sent a webhook to the URL specified when creating the order.

More information about webhooks can be found in the Webhooks section

Invoice lifetime

The specified lifespan of the account extends to the period from creation of the account to selection by the payer of coins and network for payment

After selecting a coin and network, the payer will create an order with the maximum lifetime available for the selected network.

More details can be found in the orders section.

PreviousReceiving withdrawal informationNextCreate an invoice for payment

Last updated 1 year ago