Guide to understanding the status codes returned from the Headless Checkout APIs
order.phase
and then there are sub-statuses for quote
, payment
, and delivery
.
quote:all-line-items-unavailable
- No items in the order are available for purchase at the current time
quote:expired
- The quote has expired and needs to be refreshed
quote:requires-physical-address
- Order requires a physical shipping address. During this status, payment.preparation
parameters will not be present. See Physical Good Purchases guide for details.
payment:requires-recipient
- The order needs a recipient address to be specified before proceeding
payment:requires-crypto-payer-address
- A crypto wallet address needs to be provided for the payment
payment:requires-kyc
- User needs to complete KYC verification to proceed with the payment
payment:failed-kyc
- KYC verification was rejected and the user cannot proceed
payment:manual-kyc
- KYC verification requires manual review, the user will be notified via email of the outcome
payment:awaiting-payment
- The order is ready to receive payment from the user
payment:failed
- The payment attempt failed and needs to be retried
payment:in-progress
- The payment is currently being processed
payment:completed
- The payment has been successfully completed
delivery:in-progress
- The NFT or physical item is being processed for delivery
delivery:failed
- The delivery process failed and needs to be retried
delivery:completed
- The NFT or physical item has been successfully delivered to the recipient