# Onboarding with Business Payment Service source: https://developer.mastercard.com/mastercard-supplier-payment-agent/documentation/getting-started/onboarding-with-bps/index.md ## Before you start {#before-you-start} Before you can continue, you must: * Be onboarded with Business Payment Service as a Supplier Payment Agent. * Register your suppliers in Business Payment Service and set their Supplier payment preferences. Contact your Business Payment Service representative for further details regarding onboarding with the Business Payment Service. ## Onboarding with Business Payment Service {#onboarding-with-business-payment-service} Business Payment Service uses Dynamic Sandbox Enabler, which allows customers to onboard and test in the sandbox environment efficiently. Diagram cust-onboarding2 To onboard with Business Payment Service: **Step 1.** Click **Create Project** . **Step 2.** Click the **Supplier Payment Agent** API from the dropdown menu. **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 Supplier receiving the payment. | Supplier 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. | Ryding | 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 | | Organisation Identifier Type | Organisation or identification type. | TXID | Yes | | Organisation Identifier | Organisation 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 receive payments on-behalf of a Supplier? | The answer to this question helps identify if you are a direct or indirect Business Payment 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 receive 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 Provider. A Mastercard vendor is defined as a a person (entity) that provides services to Mastercard. If you are not transacting on behalf of a Supplier, you must select either 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 Business Payment Service to send event notifications. | `https://companyname.com` `/bps/notifications` | Yes | Tip: Prospective users should review the agent types outlined in the table below. | Agent type | Initiate payments? | Customer type | |----------------------------------------------------|--------------------|---------------------------| | Supplier Payment Agent | Yes | N/A | | Mastercard Service Provider | No | Mastercard Vendor | | Processor | No | Customer Service Provider | | Supplier Payment Agent Processor | Yes | Customer Service Provider | | Supplier Payment Agent Mastercard Service Provider | Yes | Mastercard Vendor | **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 Supplier Payment Agent APIs refer to the [API basics](https://developer.mastercard.com/mastercard-supplier-payment-agent/documentation/api-basics/index.md) and [Tutorial and Guides](https://developer.mastercard.com/mastercard-supplier-payment-agent/documentation/tutorials-guides/tutorials-guides-bps/index.md) sections. For more information on Business Payment Service use cases, refer to the [Use cases](https://developer.mastercard.com/mastercard-supplier-payment-agent/documentation/use_cases/index.md) section.