PayPal provides a self-service sign-up for a sandbox account. To sign-up for an account visit the sign-up page and fill in the details, ensuring to choose Business Account when prompted.


When setting up PayPal in the Dashboard, you will need to configure the following credentials, which are obtained from PayPal:

Client ID

The PayPal Client ID can be found in the PayPal Admin Portal under the My Apps & Credentials -> REST API Apps -> Your App section.

PayPal Client ID

Client Secret

The PayPal Client Secret can also be found in the PayPal Admin Portal under the My Apps & Credentials -> REST API Apps -> Your App section.

Merchant ID

The PayPal Merchant ID can be found in the PayPal’s Merchant Account under the My Apps & Credentials -> Business Information section.

PayPal Account Configuration

Payment Receiving Preferences

By default, PayPal will only settle payments automatically if the payment is in the primary currency of the PayPal merchant account. If you need to accept payments in additional currencies, you will need to open a PayPal account balance in each of the currencies you intend to accept. Alternatively, you can configure your PayPal merchant account to automatically convert payments into the primary currency.

If you receive a payment in a currency that your PayPal merchant account is not configured to accept, the payment will enter a pending state and you will need to log-in to the PayPal merchant dashboard to trigger settlement, either by opening the required currency balance, or converting the payment into the primary currency of your PayPal account.

Please note that payments left in a pending state will eventually be reversed by PayPal.

Billing Agreements

To allow customers to tokenize their PayPal account for future payments, you will need to contact PayPal and request that your account be enabled for PayPal Billing Agreements.

Once Billing Agreements have been enabled on your PayPal merchant account, you can toggle the tokenization feature on within the PayPal connector settings in the Gr4vy Dashboard.

PayPal Payment Tokenization Toggle