Cryptopay API
Create a Sandbox AccountSign InHelpdeskLegal & 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
Prebuilt integrations
Channels
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
Payment widget
Invoice callbacks
Payouts
Testing
Risks
Customers
Transactions types and Statuses
Powered By GitBook
Underpaid

Criteria

paid_amount is less than pay_amount

Callbacks to be sent in this scenario

Callback event
Invoice status
Invoice status context
Description
transaction_created
new
null
A customer has just broadcasted their transaction on the network but paid_amount is less than pay_amount
transaction_confirmed
new
null
The transaction has been confirmed on the network
status_changed
unresolved
underpaid
The invoice needs to be resolved
status_changed
completed
null
The transaction amount was exchanged at the new exchange rate. The final invoice amount may differ from the original one
status_changed
refunded
null
The whole transaction amount was refunded

API auto settings and status flow

API Auto Settings
Payment Flow
Do nothing, I will handle them myself
new → txn sent → txn confirmed → invoice expired → unresolved:underpaid
Automatically refund to my crypto account
new → txn sent → txn confirmed → invoice expired → unresolved:underpaid → tx refunded → refunded
Automatically recalculate at a new exchange rate and settle
new → txn → txn confirmation → invoice expiration → unresolved:underpaid → tx recalculated → completed
Previous
How to handle unresolved invoices
Next
Overpaid
Last modified 2mo ago
Copy link
On this page
Criteria
Callbacks to be sent in this scenario
API auto settings and status flow