订单与充值状态¶
展示所有可能的充值状态及其转换,并提供可视化图表以便更好地理解。
订单状态¶
订单状态枚举¶
| 状态 | 描述 |
|---|---|
| CREATING | 订单正在创建中。该状态仅在使用创建提币订单(v2)接口时返回。 |
| PROCESSING | 订单正在处理中。 |
| PARTIALLY_FAILED | 批量中的部分交易失败。 |
| MANUAL_APPROVAL | 需要 KYT 或金额超过人工审核阈值。 |
| FAILED | 订单失败。 |
| ORDER_SEND_OUT | 订单已发送执行。 |
| FINISHED | 订单已成功完成。 |
| CANCELED | 订单已取消。 |
| WAITING_FOR_APPROVAL | 订单正在等待企业下审核人员审核。 |
| REJECTED | 订单审批被拒绝。 |
订单状态场景¶
使用创建提币订单(v2) 接口时,订单会先进入 CREATING 状态,再转为 PROCESSING。例如:CREATING → PROCESSING
主流程¶
标准的成功提款流程。订单被处理、发送到区块链并完成。
PROCESSING → ORDER_SEND_OUT → FINISHED
批量提款(部分失败)¶
在批量提款期间发生,当批次中的某些交易成功而其他交易失败时。
PROCESSING → ORDER_SEND_OUT → PARTIALLY_FAILED
需要业务线检查员审批¶
当订单需要业务线检查员审批时触发。
场景 A: 已批准¶
WAITING_FOR_APPROVAL → PROCESSING → ORDER_SEND_OUT → FINISHED
场景 B: 已拒绝¶
WAITING_FOR_APPROVAL → REJECTED
需要人工审批¶
当订单满足某些风险或政策条件时触发。订单暂停由我们的 Cactus 团队进行人工审核。
场景 A: 已批准¶
PROCESSING → MANUAL_APPROVAL → PROCESSING → ORDER_SEND_OUT → FINISHED
场景 B: 已拒绝¶
PROCESSING → MANUAL_APPROVAL → REJECTED
已取消¶
仅适用于 EMV 兼容链订单。当状态为 PROCESSING 或 ORDER_SEND_OUT 时可以取消订单。
PROCESSING → ORDER_SEND_OUT → CANCELED
充值状态¶
充值状态枚举¶
| 状态 | 描述 |
|---|---|
| UNCONFIRMED | 未达到安全区块高度前。 |
| CONFIRMED | 最终确认状态。 |
| ROLLBACKED | 因链上回滚而被撤销。 |
| ROLLBACKED_RBF | 因RBF导致的回滚交易。 |
| FROZEN | 资金冻结。 |
| FROZEN_REFUND_WAITING_ADDRESS | 交易被合规标记,需要您提供退款地址以继续处理。 |
| REFUNDED | 冻结的金额已成功退回 |
充值状态场景¶
主流程¶
标准的成功充值流程。充值在区块链上被检测到,并在达到所需的区块确认数后得到确认。
UNCONFIRMED → CONFIRMED
KYT 冻结,在安全高度之前释放¶
UNCONFIRMED → FROZEN → UNCONFIRMED → CONFIRMED
KYT 冻结,在安全高度之后释放¶
UNCONFIRMED → FROZEN → CONFIRMED
充值冻结并标记为退款¶
充值被标记并冻结。经过审核后,确定该充值应被退款。系统需要退款地址,然后完成退款。
UNCONFIRMED → FROZEN → FROZEN_REFUND_WAITING_ADDRESS → REFUNDED
回滚¶
当区块链回滚发生并使充值交易无效时发生。
UNCONFIRMED → ROLLBACKED
确认后回滚¶
在极少数情况下(如链上重组),充值在达到 CONFIRMED 状态之后仍可能被回滚。如果该交易之后重新上链,Cactus 团队会与您沟通确认 ROLLBACKED 事件已处理无误后,才会开始新一轮充值通知流程。
UNCONFIRMED → CONFIRMED → ROLLBACKED
UNCONFIRMED → CONFIRMED - 交易重新上链时(交易哈希相同,但 detail_id 不同)
请在设计业务逻辑时,充分考虑此场景,以防止重复记账。请注意,重新推送的入账与原入账的交易哈希(tx_id)相同,但 detail_id 不同。
如果您自定义了入账确认高度,确认高度越低,发生此情况的可能性越高。