# Onboarding with Commercial Direct Payments source: https://developer.mastercard.com/mastercard-buyer-payment-agent/documentation/getting-started/onboarding-with-cdp/index.md Before you can continue, you must: 1. Be onboarded with Commercial Direct Payments (CDP) as a Buyer Payment Agent. 2. Contact your Commercial Direct Payments representative for further details regarding onboarding with the Buyer Payment Agent. ## Onboarding with Commercial Direct Payments {#onboarding-with-commercial-direct-payments} Commercial Direct Payments uses the Dynamic Sandbox Enabler, which allows customers to onboard and test in the sandbox environment efficiently. Diagram cust-onboard-cdp To onboard with Commercial Direct Payments: **Step 1.** Click **Create Project** . **Step 2.** Click the **Buyer Payment Agent** API. **Step 3.** Name the project. **Step 4.** Fill out the form. | Field | Description | Example value | Required? | |------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------|-----------| | Legal Business Name | Identifies the legal business name of the Buyer making the payment. | Buyer Co | Yes | | Legal Address Line 1 | Business address line 1. | 6736 Mastercard Way | Yes | | Town Name | Identifies the name of the city or geographical location of the billTo address. | Town land | Yes | | Country Subdivision/State | Identifies the subdivision within a country where the business is located, such as the state, region, or county. | New Jersey | Yes | | Post Code | Identifies the mailing or ZIP code for the business. | 12587 | Yes | | Country | Identifies the country where the business is located. | United States of America | Yes | | Organization Identifier Type | Organization or identification type. | TXID | Yes | | Organization Identifier | Organization or tax identification number. | 123456789 | Yes | | Customer Identifier (CID) | A master identification number for all Mastercard customers. It can be 6-11 digits in length, but all CIDs issued today are 6 digits in length. A CID identifies a customer's unique legal entity. If a customer is defined by their legal entity, each customer should have one CID. If a customer has multiple legal entities, they can have multiple CIDs, with one for each entity. There is no limit to the number of legal entities that a customer can have. CIDs for unique legal entities under one customer can be tied together with a legal grandparent number. Currently some customers have multiple CIDs for one legal entity. | 1234567 | Yes | | Customer ICA | Interbank Card Association. Used for agent identification in all service requests for core operations. | 987654321 | Yes | | Will you be initiating the API requests to make payments on-behalf of a Buyer? | The answer to this question helps identify if you are a direct or indirect Buyer Payment Agent Service customer. **Note: If you are unsure what type of user you are, refer to the tip below.** | No | Yes | | Will you be initiating the API requests to make payments on-behalf of a Payment Agent? If yes, click the appropriate role from the list below. | A customer service provider is defined as a person (entity) that performs Program Service that is an agent of the customer that receives or otherwise benefits from program service, whether directly or indirectly, performed by such service providers. A Mastercard vendor is defined as a person (entity) that provides services to Mastercard. If you are not transacting on behalf of a Buyer, you must select either a Customer Service Provider or Mastercard vendor. **Note: If you are unsure what type of user you are, refer to the tip below.** | Customer Service Provider | Yes | | Notification URL | A unique resource location for the Buyer Payment Agent Service to send event notifications. | `https://companyname.com` `/cdp/notifications` | Yes | Tip: Prospective users should review the agent types outlined in the table below. | Agent type | Initiate payments? | Customer type | CVV required for card payments? | |-------------------------------------------------|--------------------|---------------------------|---------------------------------| | Buyer Payment Agent | Yes | N/A | No | | Mastercard Service Provider | No | Mastercard Vendor | Yes | | Processor | No | Customer Service Provider | Yes | | Buyer Payment Agent Processor | Yes | Customer Service Provider | No | | Buyer Payment Agent Mastercard Service Provider | Yes | Mastercard Vendor | No | **Step 5.** Download the sandbox signing key and click **Continue** . **Step 6.** Create an encryption key alias and keystore password. **Step 7.** Confirm that the keystore credentials are saved. Once the request has been submitted, you will receive approval within 2-3 business days. ## Next Steps {#next-steps} To start implementing the Buyer Payment Agent APIs refer to the [API Basics](https://developer.mastercard.com/mastercard-buyer-payment-agent/documentation/api-basics/index.md) and [Tutorial and Guides](https://developer.mastercard.com/mastercard-buyer-payment-agent/documentation/tutorials-guides/tutorials-guides-cdp/index.md) sections. For more information on Buyer Payment Agent use cases, refer to the [Use Case](https://developer.mastercard.com/mastercard-buyer-payment-agent/documentation/use_cases/index.md) section.