# Onboarding

Set up your PayPal, Google Pay, Apple Pay, or Paze merchant accounts in the Unity Portal.

## Before you start

If you haven't already, make sure that you have activated the *Checkout Drop-in* service and any relevant payment method services in the Unity Portal. For more information, see our [Activation guide](/guides/checkout/drop-in/activation).

## Complete the onboarding process

PayPal
### PayPal

Connect your PayPal Business account to your site so you can accept PayPal payments.

Log in with an existing account
1. In the Unity Portal, go to **Merchant setup > Sites**.
2. Select a site.
3. In the **Services** tab, find the *PayPal service* and click **Edit**.
4. Click **PayPal account**.
5. Click **Connect PayPal account**. A PayPal pop-up opens.
6. Enter your credentials, then click **Next**.
7. Click **Agree and Continue**. A confirmation message is displayed.
8. Click **Return to PXP** to go back to the Unity Portal.


If your connection is successful, a success message is displayed and your connection details are visible. You're now ready to accept PayPal payments.

If your connection is unsuccessful, a warning is displayed. See the [troubleshooting](#troubleshooting) section below for more information.

Create a new account
1. In the Unity Portal, go to **Merchant setup > Sites**.
2. Select a site.
3. In the **Services** tab, find the *PayPal service* and click **Edit**.
4. Click **PayPal account**.
5. Click **Connect PayPal account**. A PayPal pop-up opens.
6. Click **Create An Account**.
7. Enter your legal name, email address, and a password, then click **Create Account** to confirm.
8. Add your business and personal information, then click **Submit**. A confirmation message is displayed.
9. Click **Return to PXP** to go back to the Unity Portal.


If your connection is successful, a success message is displayed and your connection details are visible. You're now ready to accept PayPal payments.

If your connection is unsuccessful, a warning is displayed. See the [troubleshooting](#troubleshooting) section below for more information.

### Troubleshooting

If there are any issues with the connection to your PayPal account, then a warning is displayed at the top of the screen.

| Issue | Description |
|  --- | --- |
| Primary email confirmed | This error indicates that you haven't confirmed your primary email address on the PayPal website. To fix it, go to your Paypal settings.Once you've confirmed your email address, refresh the Unity Portal to view your updated onboarding status. |
| Payments receivable | This error indicates that there are limitations place on your PayPal account, which prevent you from accepting payments. This could be for a number of reasons, such as an excessive number of chargebacks or non-compliance with regulatory requirements. To fix it, reach out to the PayPal customer service or go to the PayPal website to find out more. |


Apple Pay
### Apple Pay

Set up your merchant ID and certificates, so you can start accepting Apple Pay.

You can use either:

- Your Apple developer account, if you already have an account and want to manage your own certificates.
- PXP's account, if you don't have an Apple Developer account and/or don't want to manage certificates yourself.


Use PXP's Apple Pay account
1. In the Unity Portal, go to **Merchant setup > Sites**.
2. Select a site.
3. In the **Services** tab, click **Edit** next to *Apple Pay service*.
4. Click **Register account**.
5. Select **Use PXP's Apple Pay Account**, then click **Continue**.
6. Click **Register ID**.
7. Click ** Domain verification file** and save the file locally.
8. Upload the file to your domain, at the following path: `https://{your-domain}/.well-known/apple-developer-merchantid-domain-association`.
9. Click **Register domain.**


Once your domain is verified, your list of domains is updated and your Apple Pay setup with PXP is complete.

Use your developer account
### Step 1: Create a merchant account and merchant ID

1. Log in to your Apple Developer Account.
2. Go to **Certificates, Identifiers & Profiles**.
3. Go to **Identifiers**, then click the **+** button.
4. Choose *Merchant IDs* as the identifier type, then click **Continue**.
5. Enter a description and a merchant ID in the format: `merchant.com.mycompany.mystore`.
6. Click **Continue** then **Register** to confirm.


Your list of identifiers is updated to include your new merchant ID. Copy this to your clipboard.

### Step 2: Download the CSR from the Unity Portal

1. In the Unity Portal, go to **Merchant setup > Sites**.
2. Select a site.
3. In the **Services** tab, click **Edit** next to *Apple Pay service*.
4. Click **Register account**.
5. Select **Use my Apple Developer Account**, then click **Continue**.
6. Click **Provider authorisation settings**.
7. Enter your Apple merchant ID and click **Register ID**.
8. Click **Download CSR file** and save the `.csr` file locally.


### Step 3: Create a mechant identity certificate (.PEM)

1. In your Apple Developer Account, go to **Certificates, Identifiers & Profiles**.
2. Go to **Certificates**, then click the **+** button.
3. Choose *Apple Pay Merchant Identity Certificate*, then click **Continue**.
4. Select the merchant ID you created earlier, then click **Continue**.
5. Upload the CSR file you downloaded from the Unity Portal, then click **Continue**. Your certificate is generated.
6. Click **Download** and save the `.cer` file locally.
7. Convert it to `.p12` format:
  1. Double-click on the `.cer` file to open it in Keychain Assistant.
  2. Right-click to export.
  3. Save this `.p12` file.
  4. Skip the password.
  5. Enter your system password to authenticate and complete the export processing.
8. Export your `.p12` to `.pem` via openSSL command:

```
% openssl pkcs12 -in <filename>.p12 -out <filename>.pem -nodes
```
9. In the Unity Portal, upload this file under *Merchant identity certificate (.PEM)*.


### Step 4: Create a payment processing certificate (.CER)

1. In your Apple Developer Account, go to **Certificates, Identifiers & Profiles**.
2. Go to **Certificates**, then click the **+** button.
3. Under Apple Pay, choose *Payment Processing Certificate* and click **Continue**.
4. Select your Merchant ID, then click **Continue**.
5. Upload the same CSR file from the Unity Portal, then click **Continue**.
6. Download the generated `.cer` file.
7. In the Unity Portal, upload this file under *Payment processing certificate (.CER)*.


After both certificates are uploaded, your Apple Pay setup with PXP is complete.

Any future merchant ID changes require re-uploading new certificates.

Google Pay
### Google Pay

Set up your Google Pay business profile and integration settings.

### Step 1: Create a Google Pay business profile

1. Go to the Google Pay Business Console.
2. Sign in with your Google account or create a new one.
3. Click **Get started** to create your business profile.
4. Enter your business information:
  - Legal business name.
  - Business address.
  - Business type.
  - Website URL.
5. Review and accept the Google Pay API Terms of Service.
6. Click **Submit** to create your profile.


Your Google Pay Business Profile is now created and pending approval.

### Step 2: Create a web integration

1. In the Google Pay Business Console, go to **Google Pay API**.
2. Click **Web integration** and accept the terms and conditions.
3. Enter your website URL.
4. Select the *Gateway* integration type.
5. Upload screenshots of your checkout flow.


Screenshot of the Google Pay Business Console
1. Click **Save** to confirm.


If your business profile has been approved, you can click the **Submit for approval** button. If your business profile hasn't been approved yet, you'll need to wait until it is.

Once your web integration is also approved, you're ready to register your Google ID in the Unity Portal.

### Step 3: Register your Google ID in the Unity Portal

1. In the Unity Portal, go to **Merchant setup > Merchant groups**.
2. Select a merchant group.
3. In the *Services* tab, click **Edit** next to *Google Pay service*.
4. Click **Register account**.
5. Enter your Google merchant ID and click **Register ID**.


Your Google Pay setup with PXP is complete.