Txn.pro - API Documentation
Sandbox LoginChangelogStatus Page
  • Getting setup
    • Environments
    • Creating a Sandbox account
    • Back office user roles
    • Creating your API keys
    • Postman collection
  • API Basics
    • API specification
    • API status
    • Supported currencies
    • Date and time format
    • Authenticating the API
    • Webhooks
      • Verifying webhooks
      • Source IP addresses
      • Retrying schedule
    • Rate limits
  • Hosted pages
  • Accounts
    • Accounts concept
    • Listing accounts
    • Reading account
    • Listing account addresses
    • Creating account address
    • Listing account transactions
    • Reading account transaction
  • Exchange
    • Exchange concept
    • Supported currency pairs
    • Reading exchange rates
    • Exchange webhooks
    • Creating quote
    • Confirming quote
  • Invoices
    • Invoices concept
    • Invoice status flow
    • Invoices in cashier
    • Invoice limitations
    • Listing invoice currency pairs
    • Invoice webhooks
    • Creating invoice
    • Reading invoice
    • Listing invoices
    • Invoice refunds
  • Payouts
    • Payouts concept
    • Payout status flow
    • Payout limitations
    • Listing payout currency pairs
    • Validating addresses
    • Payout webhooks
    • Creating payout
    • Reading payout
    • Listing payouts
  • Mass Payouts
  • PAYMENT LINKS
    • Payment links concept
    • Creating payment link
    • Expiring payment link
    • Reading payment link
    • Listing payment links
  • CHANNELS
    • Channels concept
    • Channels deposit flow
    • Listing channel currency pairs
    • Channel webhooks
    • Creating channel
    • Reading channel
    • Updating channel
    • Listing channels
    • Listing channel deposits
    • Reading channel deposit
  • (BETA) Fiat Settlements
    • Important information
    • Bank withdrawal webhooks
    • Bank deposit webhooks
    • Listing bank accounts
    • Reading bank account
    • Previewing bank withdrawal
    • Creating bank withdrawal
    • Listing bank withdrawals
    • Reading bank withdrawal
    • Listing bank deposits
    • Reading bank deposit
Powered by GitBook
On this page
  • Which currencies can invoice be paid in?
  • What are the minimum and maximum invoice amounts?
  • How long is the exchange rate provided by Txn valid?
  • How long is the invoice valid once it's created?
  • What statuses can I expect my invoice to be updated to?
  • How long does it take Txn to process a payment?
  • What happens after the invoice expires?
  • What happens if the end user sends less or more cryptocurrency than they were quoted?
  1. Invoices

Invoices concept

PreviousConfirming quoteNextInvoice status flow

Last updated 7 months ago

Crypto invoices are electronic bills issued by merchants to their customers for goods or services, with payment expected in cryptocurrency rather than traditional fiat currency. These invoices typically include details such as the amount due, the accepted cryptocurrency for payment, the payment address and QR code, and a provided by Txn exchange rate locked in for a 20-minute period, during which the end user is expected to pay the invoice.

For better context, below is a diagram illustrating the invoice payment flow for each party involved in this process.

Which currencies can invoice be paid in?

What are the minimum and maximum invoice amounts?

How long is the exchange rate provided by Txn valid?

Invoice exchange rates are valid for 20 minutes.

How long is the invoice valid once it's created?

An invoice remains valid for 20 minutes, during which end users should send a cryptocurrency transaction to the invoice's address.

What statuses can I expect my invoice to be updated to?

How long does it take Txn to process a payment?

Once a cryptocurrency transaction is detected at the invoice's receiving address, Txn updates the invoice status from pending to processing.

The time it takes for Txn to complete the invoice depends on how quickly the transaction is included in a block on the blockchain. If the network experiences congestion during spikes in activity, it may take a bit longer. Normally, payments are processed within minutes. However, payments on the Bitcoin blockchain may take a bit longer due to the design of the Bitcoin blockchain, which produces a new block approximately every 10 minutes.

As soon as the cryptocurrency transaction is included in a block, Txn updates the invoice status from processing to completed.

What happens after the invoice expires?

After the invoice expires, meaning no cryptocurrency transaction has been sent by the end user to the invoice address during the invoice validity period, Txn continues to monitor the invoice address for the next 7 days. If your customer sends their cryptocurrency transaction after the invoice expires, Txn will process it and update the invoice status accordingly.

After 7 days from the invoice creation date and time, Txn stops monitoring the invoice address. If any transaction is sent after 7 days, Txn will receive the transaction, but the payment will not be reflected on the corresponding invoice. This 7-day limitation is set due to the large number of cryptocurrency receive addresses our platform generates and monitors. Additionally, in our experience, it is an extremely rare case when end users send funds after 7 days.

What happens if the end user sends less or more cryptocurrency than they were quoted?

Normally, end users send the exact amount of cryptocurrency they are asked to send to the invoice address to complete their payment.

However, sometimes, end users send slightly more or less cryptocurrency because they either didn't pay enough attention during the withdrawal process from their wallet provider or their wallet provider wasn't clear enough with the end user on how they charge network fees. These two reasons are primarily what cause underpayments and overpayments.

If your end users end up sending less or more cryptocurrency, Txn will process such transactions as normal, except that a spot exchange rate will be applied when converting crypto to fiat and crediting the payment to your account on Txn. You can expect the final invoice status to be completed in this scenario.

The complete list of supported cryptocurrencies and tokens can found on the page.

You can find invoice minimum and maximum amount settings per currency on the page.

Please refer to the page in this documentation.

Alternatively, if you do not want to accept a payment and wish to return funds back to your end-user instead, please have a read the documentation.

Supported currencies
Invoice limitations
Invoice status flow
Invoice Refunds
Invoice payment process flow