# API Credentials

Learn how credentials work across Payment Network services.

API credentials identify your application and authorize access to Payment Network services.

During onboarding, Deluxe provides the credentials required for authentication, API access, and service-specific requests. Different credentials are used to obtain access tokens, access Payment Network APIs, and access Deluxe Directory Network (DDN) services.

Understanding when and where each credential is used can help prevent authentication and authorization errors during development and testing.

Don't have credentials yet? Complete [onboarding](/products/deluxe-payment-network/build-with-deluxe/get-started) before continuing with implementation.

### Credentials

Obtain the following credentials during onboarding:

| Credential | Purpose |
|  --- | --- |
| Client ID | Used to request access tokens |
| Client Secret | Used to request access tokens |
| `businessPartner` | Required for Payment Network APIs |
| `apiKey` | Required for Directory Network APIs (if applicable) |


Store credentials securely. Never expose Client Secrets or API keys in source code repositories, browser applications, or other public locations.

### Client ID and Client Secret

Use the Client ID and Client Secret to obtain OAuth access tokens.

The API authentication workflow shows how client credentials are used to generate an access token, which authorizes subsequent API requests.

**Provide Client Credentials**
Use the Client ID and Client Secret as the credentials required for authentication.

**Generate Access Token**
Submit an OAuth token request to generate an access token.

**Access APIs**
Use the access token to authenticate and authorize API requests.

Learn more: [Setup Your Environment →](/products/deluxe-payment-network/build-with-deluxe/authenticate-guide)

### businessPartner

The `businessPartner` value identifies your organization within Payment Network.

Include this header when calling Payment Network APIs.

`businessPartner: ExampleCompany`

Common uses include:

- Uploading payment files
- Retrieving file status
- Retrieving payment status
- Reconciliation workflows


### apiKey

The `apiKey` is used to access Deluxe Directory Network (DDN) services.

Include this header when calling Directory Network APIs.

`apiKey: your-api-key`

Common uses include:

- Lockbox directory lookups
- Directory searches
- Pre-matching workflows


### Keep Credentials Secure

- Store credentials in a secure secrets manager.
- Rotate credentials if exposure is suspected.


Treat all credentials as sensitive information.

### Need Help?

If credentials are lost, expired, or compromised, contact [Deluxe Support →](/products/deluxe-payment-network/developer-resources/support).