跳转至

订单与充值状态

展示所有可能的充值状态及其转换,并提供可视化图表以便更好地理解。

订单状态

订单状态枚举

状态描述
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 不同。

如果您自定义了入账确认高度,确认高度越低,发生此情况的可能性越高。