Cryptopay API
Create a Sandbox Account
Sign In
Helpdesk
Legal & Privacy
Search…
Welcome
Guides
Introduction
Environments
Creating a Test Account
API Credentials
API Basics
API Client Libraries
API Reference
Cryptocurrency Payments
Supported Currencies
Currency Icons
Confirmations
Channels
Invoices
Invoice statuses
Invoice payment sequence
How to handle unresolved invoices
Create an invoice
Visual presentation at Cashier
Invoice hosted page
Payment widget
Invoice callbacks
Payouts
Testing
Risks
Customers
Transactions types and Statuses
Powered By
GitBook
Invoice payment sequence
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
create an invoice
​
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
​
Previous
Invoice statuses
Next
How to handle unresolved invoices
Last modified
1mo ago
Copy link