Skip to content

Lifecycle and statuses

An RDP moves through a small set of statuses from creation to completion or cancellation.

The RDP status describes the overall Country Workspace workflow. Individual RDP operations have their own statuses and recovery flow.

RDP state flow

stateDiagram-v2
    [*] --> PENDING: Create RDP

    PENDING --> REVIEW_PENDING: Manual review required
    PENDING --> PUSH_PENDING: Ready to push

    REVIEW_PENDING --> PUSH_PENDING: Push all to HOPE
    REVIEW_PENDING --> CANCELLED: Cancel
    REVIEW_PENDING --> CANCELLED: Create clean RDP

    PUSH_PENDING --> SUCCESS: Push succeeds
    PUSH_PENDING --> FAILURE: Push fails

    FAILURE --> PUSH_PENDING: Retry push
    FAILURE --> CANCELLED: Cancel

    PENDING --> CANCELLED: Cancel
    SUCCESS --> CANCELLED: Staff Reset

Create clean RDP cancels the reviewed RDP and creates a new PENDING RDP that starts its own processing. See Review and Clean RDP.

Statuses

Status Meaning
PENDING The RDP is being processed before push. Operations may still be pending, running, or waiting for recovery.
REVIEW_PENDING Processing completed successfully, but one or more operation thresholds require manual review.
PUSH_PENDING A push to HOPE Core is in progress. This can include RDI reset, waiting for HOPE, and data transfer.
SUCCESS The RDP push completed successfully.
FAILURE The push attempt failed. The RDP can be retried when the required conditions are satisfied.
CANCELLED The RDP was cancelled and no further processing is expected.

Only one non-terminal RDP can exist for a Program at a time. PENDING, REVIEW_PENDING, PUSH_PENDING, and FAILURE are non-terminal statuses.

Processing and review

A newly created RDP starts in PENDING while Country Workspace runs its configured RDP operations.

An operation failure does not change the RDP to FAILURE; the RDP remains PENDING. Failed or otherwise recoverable operations can use Retry operations.

After all configured operations complete successfully, Country Workspace evaluates their review thresholds. If no threshold is exceeded, the RDP moves to PUSH_PENDING and the HOPE Core push starts automatically. Otherwise, it moves to REVIEW_PENDING.

From REVIEW_PENDING, the user can Push all to HOPE, Create clean RDP, or Cancel RDP. See Review and Clean RDP for the complete review flow.

Push status changes

When the RDP is ready to be pushed, its status changes to PUSH_PENDING.

The RDP remains PUSH_PENDING while Country Workspace prepares HOPE Core, waits for HOPE when necessary, and sends beneficiary data.

A successful push changes the RDP to SUCCESS. A failed push attempt changes it to FAILURE; use Retry push to HOPE to start another push attempt.

See Push to HOPE Core for the complete push workflow.

Recover a stuck push

If an RDP remains in PUSH_PENDING because the push can no longer continue, authorized staff can use Fail stuck push in Staff Administration.

Use this recovery action only after confirming that the push preparation job is no longer running and, when applicable, that the HOPE callback is no longer expected.

Country Workspace allows recovery only for the active push attempt when its preparation job exists and the data-push job has not yet been scheduled. Successful recovery changes the RDP to FAILURE.

Fail stuck push is a temporary recovery action and is expected to be removed when automatic recovery is available.

See Retry a failed push and Troubleshooting for further recovery guidance.

Cancel an RDP

Cancel RDP is available for RDPs in PENDING, REVIEW_PENDING, or FAILURE.

Cancellation is blocked while an RDP operation is RUNNING. For biometric RDPs, Country Workspace must also verify that the associated Deduplication Set can be safely handled; cancellation fails if its state cannot be handled or verified. When cancellation succeeds, the set is rejected when required. If the RDP is linked to a HOPE RDI, Country Workspace asks the user to confirm that the RDI has been deleted manually in HOPE before cancellation continues. Operations that have not started yet do not block cancellation.

Cancellation from REVIEW_PENDING is one of the review decisions. See Biometric deduplication for DedupEngine cleanup.

Staff Reset

In Staff Administration, the latest SUCCESS RDP for a Program can be reset.

Reset marks the related beneficiary records as not removed and changes the RDP from SUCCESS to CANCELLED.

Staff Reset changes Country Workspace state only. It does not reverse processing already completed in HOPE Core.

Processing flow

For the end-to-end interaction between RDP operations, external processing services, review, and HOPE Core, see RDP processing flow.