Get started

DocsCurrent

Last updated: May 23rd, 12:13am

As part of the payment method integration, you would have completed the following steps. If not, ensure to do so. For more information, see Set up your development environment:

Create sandbox accounts.

Set up the sandbox environment.

Retrieve sandbox app credentials: To implement the flows in this integration section and test them successfully, you require the following sandbox credentials for your app:
- Client ID: App identifier that helps with account authentication.
- Client secret: App credential that helps with app authorization.

Retrieve sandbox account credentials: To successfully test the flows in this integration guide, in sandbox, you should:
1. Run the app in your local environment and initiate payment processing acting as a buyer.
2. For PayPal wallet: Log in to your sandbox personal account and sandbox business account (test site) and verify if the funds have moved from the personal account to the business account.
3. For other payments: Log in to your sandbox business account (test site) and verify if the funds have moved to the business account, in the appropriate currency.
To do this, you require the sandbox personal and business account log-in credentials. For information on how to retrieve the log-in credentials from your developer account, see Get sandbox account credentials.

Set up the development environment.

Reference - Key terms

As part of your business account configuration, PayPal sets default values for the following entities.

Primary currency: The key currency in which you prefer to hold the balance in your PayPal business account. During payment processing, PayPal converts the buyer’s payments into your account’s primary currency and settles the money. For information on how to know your primary currency and modify it, see View and modify primary currency.

Holding currencies: The currencies in which you can hold the balance in your PayPal business account and present prices to your buyers. PayPal sets the default holding currencies based on your account’s country eligibility. You can modify the set of holding currencies. For more information, see Manage holding currencies.

Presentment currencies: The currencies in which you can present prices to your buyers but cannot hold balances. PayPal sets your account’s presentment currencies based on your account’s currency eligibility.

Other useful terms

Quote currency | Buyer currency | Payment currency | Transaction currency: The buyer’s local currency in which you can display a product’s price and accept payments. When requesting an exchange rate, the quote currency is the currency into which your base currency is converted. Your app can use your business account’s holding and presentment currencies as quote currency. For information on the list of possible quote currency values, see Quote (presentment) currency codes.

Base currency | Settlement currency: TThe currency in which PayPal transfers (settles) money into your business account. When requesting an exchange rate, the base currency is the currency that is converted into the buyer’s currency. Your app can use your business account’s holding currencies as base currency. For information on the list of possible quote currency values, see Settlement currency codes.

Set up production business account

View and modify primary currency

Hover over your name and select Account Settings from the dropdown menu.

Navigate to Money, Banks, and Card.

Under Currency Management, the currency marked as Primary is your primary currency. To modify your primary currency, select another currency.

Manage holding currencies

Hover over your name and select Account Settings from the dropdown menu.

Navigate to Money, Banks, and Card.

Under Currency Management, you can add or remove the currencies in which you can hold balances in your account.

Set payment receiving preferences

For PayPal to settle payments in a currency that is not your account’s holding currency, ensure to set your payment receiving preferences. You can opt to convert any payment into your primary currency, for automatic settlement. Otherwise, the payment status remains pending until you manually approve the payment in your PayPal account.

To do this:

Hover over your name and from the dropdown menu, select Account Settings > Payment Preferences > Block Payments and unblock payments sent to you in a currency that is not your holding currency.

Optionally, you can block or unblock the following:
- Payments from U.S. customers who do not have a confirmed address.
- Payments for duplicate invoice IDs.
- Payments from customers who have non-U.S. PayPal accounts.

Select Update to update your settings.