Deposit Statuses

Receiving Purchase and Deposit Updates (Hybrid Webhook + API)

Deposit Statuses:

For Both Widget Types:

• Confirming – The full amount has been received, and the system is now waiting for the required number of blockchain confirmations to mark the deposit as successful.

• Unconfirmed – A deposit has been detected on the blockchain but has not yet been included in a block (only relevant for UTXO-based networks such as Bitcoin).

• Completed – The required number of blockchain confirmations has been received, and the deposit is finalized successfully.

• PendingFork - Tx confirmed on a forked block; credit on hold until reorg resolves. After settlement, the deposit may complete or fail.

• Failed - The deposit cannot be credited (e.g., transaction invalid/dropped, double-spent or replaced via RBF to a different address). The payment attempt should be considered unsuccessful.

Purchase Widget Type only:

• Initiated – The deposit request has been created, but no blockchain deposit address has been assigned yet.

• Allocated – A unique blockchain address has been successfully generated and linked to the deposit.

• Undercharge – The customer deposited less than the expected amount, but the deposit window is still active, allowing them to complete the payment.

• UnderchargeExpired – The customer deposited less than the required amount, and the payment window has expired, meaning the transaction cannot be completed.

• Overcharge – The customer deposited more than the required amount. The deposit will still be processed, and the system may handle the excess according to predefined rules (e.g., ignore, credit, or refund).

• Expired – The customer did not complete the payment within the allowed time window, and the transaction is no longer valid.