# About APIs

Explore the APIs behind the payment lifecycle.

Payment Network provides APIs for submitting payments, monitoring processing status, and retrieving lockbox directory information.

Most integrations use three API groups: Authentication, Payment Network, and Deluxe Directory Network (DDN).

Use this page to understand how these APIs work together and where each API fits within the payment lifecycle.

New to Payment Network? Start with [onboarding](/products/deluxe-payment-network/build-with-deluxe/get-started) and environment setup.

### How the APIs Fit Together

A typical integration follows this sequence:

The DPN payment submission workflow shows how a payment disburser authenticates with DPN APIs, submits a payment file, monitors processing status, and reconciles completed payments. Lockbox information can optionally be retrieved before submission, and payment status updates and acknowledgements can be retrieved during status tracking.

**Authenticate**
Obtain an access token and establish authentication with DPN APIs.

**Look Up Lockbox Information**
Optionally retrieve lockbox details when needed before submitting the payment.

**Submit Payment File**
Submit the payment instructions and remittance data for processing.

**Monitor File Status**
Track processing progress and file-level outcomes.

**Retrieve Payment Status**
Retrieve payment status updates and acknowledgements as needed.

**Reconcile Payments**
Confirm completion and reconcile the payment records.

A submitted [payment file](/products/deluxe-payment-network/developer-resources/file-definitions) is assigned a unique file identifier. Use this value when retrieving processing information.

Not every implementation uses DDN. However, DDN can help improve routing accuracy for Print + Scan workflows.

### Authentication

[Setup your environment](/products/deluxe-payment-network/build-with-deluxe/authenticate-guide) to obtain an OAuth access token.

All Payment Network and Directory Network requests require a valid bearer token.

### Payment Network APIs

Use [Payment Network APIs](/products/deluxe-payment-network/api/dpn-api/openapi) to submit and monitor payments.

Common tasks include:

- Uploading payment files
- Retrieving file status information
- Retrieving payment status information
- Supporting reconciliation workflows


The Payment Network API is the primary integration surface for most customers.

### Deluxe Directory Network (DDN)

Use DDN APIs to retrieve lockbox directory information before submitting payments.

Common use cases include:

- Looking up lockbox destinations
- Pre-matching payments
- Validating routing information
- Retrieving lockbox directory information prior to submission


DDN supports pre-submission planning and validation. Payment Network performs destination matching during payment processing.

### API Summary

| API | Purpose |
|  --- | --- |
| Authentication | Generate access tokens for API requests |
| Payment Network | Submit payments and retrieve processing information |
| DDN | Retrieve lockbox directory information |


### Which API Should I Use?

| Goal | API |
|  --- | --- |
| Obtain an access token | Authentication |
| Submit payment files | Payment Network |
| Check file status | Payment Network |
| Check payment status | Payment Network |
| Reconcile payments | Payment Network |
| Lookup lockbox information | DDN |
| Validate payment destinations | DDN |