Cryptopay API
  • Welcome
  • Guides
    • Introduction
    • Environments
    • Creating a Test Account
    • API Credentials
    • API Basics
      • Responses
      • Date formats
      • Authentication
        • How it works
        • Signature
        • Creating a signature. Code samples
      • Callbacks
    • API Client Libraries
    • API Reference
    • Cryptocurrency Payments
    • Currencies
      • Supported Currencies
      • Currency Icons
    • Confirmations
    • Tools for accepting payments
    • Prebuilt integrations
      • E-commerce payment plugins
      • Payment and software providers
    • Channels
      • Channel payment
      • Payment statuses
      • Channel payment sequence
      • Create a Channel
      • Visual representation at Cashier
      • Channel hosted page
      • Channel payment callbacks
    • Invoices
      • Invoice statuses
      • Invoice payment sequence
      • How to handle unresolved invoices
        • Underpaid
        • Overpaid
        • Paid late
        • Illicit resource
        • Invoice refunds sequence
      • Create an invoice
      • Visual presentation at Cashier
      • Invoice hosted page
      • Online checkout
        • How-to
      • Payment links
      • Invoice callbacks
    • Payouts
      • Payout statuses
      • Payout sequence
      • Payout fees consideration
        • Network fees
      • Create a Coin Withdrawal
        • Possible errors
        • Withdrawals from fiat accounts
        • Withdrawals from cryptocurrency accounts
        • high_risk_address error message
      • Visual representation at Cashier
      • Minimum transaction amount
      • Coin Withdrawal callbacks
      • Travel Rule Compliance
    • Email Billing
      • Create an email billing
      • Email billing callbacks
    • Testing
      • Channels
      • Invoices
      • Payouts
    • Risks
    • Customers
    • Transactions types and Statuses
Powered by GitBook
On this page
  1. Guides
  2. Invoices

Invoice payment sequence

PreviousInvoice statusesNextHow to handle unresolved invoices

Last updated 9 months ago

Invoice payment sequence.

Once an invoice is created, we start monitoring its cryptocurrency address to detect inbound transactions.

  1. The customer specifies a purchase amount and purchase currency (if necessary)

  2. The merchant makes an API call POST /api/invoices to

  3. Cryptopay responds with the invoice details

  4. The merchant displays the payment details to the customer (a destination wallet address, an exact amount to send, a QR code etc)

  5. The customer broadcasts a cryptocurrency transaction

  6. Cryptopay sends the 1st callback to notify the merchant about the fact that the customer has just broadcast their transaction

  7. Cryptopay is waiting for the transaction to be confirmed on the network

  8. Cryptopay sends the 2nd callback to notify the merchant about the fact that the transaction has been confirmed

  9. Cryptopay changes the invoice status from new to completed and sends the final callback

  10. The merchant makes an API call GET /api/invoices/:id to retrieve the invoice status

  11. The invoice status is returned

  12. The merchant marks the payment as successful on their side

create an invoice