# Payment Statuses

Understand each stage of payment processing.

Payment status indicates the current stage of processing for a payment.

As a payment moves through validation, fulfillment, lockbox processing, and reconciliation, Payment Network updates its status to reflect the latest processing outcome. Payment status is returned by the Fetch Payment Status endpoint.

A payment reaches a **terminal status** when processing is complete and no additional status changes are expected.

### File Status vs. Payment Status

A payment file contains one or more payment records submitted to Payment Network for processing.

- **File status** indicates the overall processing state of the submitted file.
- **Payment status** indicates the processing state of an individual payment within that file.


Use file status to confirm that a file was received and accepted. Use payment status to monitor fulfillment progress and determine the final outcome of a specific payment.

### How Status is Updated?

Payment status is updated as processing progresses through the payment lifecycle.

For Print + Scan workflows, DPN receives processing updates and acknowledgements from participating lockbox providers. DPN uses this activity to update payment status and sub-status values as the payment moves toward a final outcome.

As a result, status information reflects both DPN processing activity and downstream acknowledgement events returned during fulfillment.

### Print + Scan

The payment status lifecycle shows how a payment moves from receipt through validation, processing, production, and completion. A payment can also move to a failed status if the payment cannot be processed successfully.

**Received**
Payment Network received the payment and started intake processing.

**Accepted**
The payment passed validation and was queued for fulfillment.

**Processing**
The payment is being prepared for fulfillment.

**In Production**
Print and scan fulfillment activities are underway.

**Completed**
Payment processing and fulfillment are complete.

**Failed**
If the payment cannot be processed successfully, the payment moves to the failed status.

#### Status Definitions

| Status | Description |
|  --- | --- |
| Received | Payment Network received the payment and started intake processing. |
| Accepted | The payment passed validation and was queued for fulfillment. |
| Processing | The payment is being prepared for fulfillment. |
| In Production | The payment package has been delivered for fulfillment and lockbox processing. |
| Completed | Processing is complete. This is a terminal status. |
| Failed | The payment could not be processed successfully. This is a terminal status. |


#### Sub-Status

Some Print + Scan statuses include additional detail through a sub-status.

##### Received

| Sub-Status | Description |
|  --- | --- |
| SystemIsValidating | Payment Network is validating the payment and matching it to a lockbox configuration. |


##### In Production

| Sub-Status | Description |
|  --- | --- |
| DeliveredToLockbox | The payment package has been delivered to the lockbox provider. |


##### Completed

| Sub-Status | Description |
|  --- | --- |
| AcceptedByLockbox | The lockbox accepted the payment for processing. |
| RejectedByLockbox | The lockbox received the payment but rejected it during processing. |


### Print + Mail

The payment status lifecycle shows how a payment moves from acceptance through processing, production, and completion. A payment can also move to a failed status if the payment cannot be processed successfully.

**Accepted**
The payment was received and passed validation.

**Processing**
The payment is being prepared for fulfillment.

**In Production**
The payment is being printed and prepared for delivery.

**Completed**
Payment processing and fulfillment are complete.

**Failed**
If the payment cannot be processed successfully, the payment moves to the failed status.

Print + Mail statuses do not include sub-statuses.

#### Status Definitions

| Status | Description |
|  --- | --- |
| Accepted | The payment was received and passed validation. |
| Processing | The payment is being prepared for fulfillment. |
| In Production | The payment is being printed and prepared for delivery. |
| Completed | Processing and fulfillment are complete. This is a terminal status. |
| Failed | The payment could not be processed successfully. This is a terminal status. |


### Terminal Status

A terminal status indicates that processing has finished and no additional status changes are expected.

| Status | Terminal |
|  --- | --- |
| Completed | Yes |
| Failed | Yes |


Applications should monitor payments until a terminal status is reached.