BxBytix

Statuses

Order and payout statuses returned on create, query, and webhooks.

Orders

StatusMeaning
pendingCreated; quote not locked.
awaiting_paymentQuote locked; waiting for funds.
paid_partialPart of the quote arrived and the timer is still running. Anything else sent to the same address counts.
paidThe total received is within your tolerances of the quote, or a review was accepted. Balance reflects crypto received.
paid_overMore than the quote plus overpay tolerance, accepted in review.
reviewStill short when the timer ended, over the overpay tolerance, or the wrong network or token. It waits for a person to accept or reject it, and anything sent to its address meanwhile counts. Do not fulfil yet.
expiredTimer elapsed while still open.
cancelledPayer closed checkout.

Payouts

StatusMeaning
awaiting_approvalCustomer withdrawal created. The net USD amount is held until the merchant approves.
pendingApproved, being handed to the network.
submittedApproved and sent on-chain.
completedOn-chain confirmation received.
rejectedMerchant declined. The held amount returns to the balance.
failedDid not complete. The held amount returns to the balance.

Open vs terminal

Open orders are pending, awaiting_payment, and paid_partial. Reading an open order after expiry marks it expired and emits order.expired. A paid_partial order still short when the timer ends goes to review instead. review is held until someone accepts or rejects it, and it does not expire. Paid and paid_over cannot be cancelled (40900). There is no CRM refund endpoint in this API. Customer payouts are open as awaiting_approval, pending or submitted. Rejected and failed payouts return the held amount to the balance.

Matching events

Webhooks fire as order.paid, order.paid_partial, order.paid_over, order.review, order.expired, and order.cancelled. Payouts fire the same name as the row status: payout.awaiting_approval, payout.pending, payout.rejected, payout.submitted, payout.completed, and payout.failed. Full payloads on Payment notification and Payout notification.