API ReferenceIntegrationsKnowledge Base

Paypal

PayPal is a payment method that you can integrate with any of your Razorpay Checkout integrations to accept payments in international currencies.

Advantages#

Integrating Paypal as a payment method on Checkout offers you the following advantages:

  • Better Success Rates
    Enjoy up to 20% higher success rates.
  • Faster Settlement time
    Get paid on a T+1 settlement schedule.
  • Wide user base
    Reach Over 30 Crore PayPal users around the world.
  • No additional charges
    Transactions will be charged as per the rates defined by PayPal.

International Payments Only:
Currently, you can only accept payments in international currencies using PayPal.

You CANNOT accept payments in INR using PayPal.

Onboarding Process to enable PayPal#

Below is the onboarding process to enable PayPal on your checkout form.

Note:
The PayPal section is visible only on the Live mode on the Razorpay Dashboard.

  1. Go to Settings on your Razorpay Dashboard.
  2. Scroll to the PayPal section and click Link Account. link paypal account
  3. Upon redirection to PayPal:
    • If you do not have a PayPal account, you need to complete the verification process and KYC. This will include confirming your email address by clicking on the link sent to you by PayPal.
    • If you already have a PayPal account, you just need to authorize Razorpay to accept payments.

You should now be able to see your PayPal enablement status set to Pending on your Dashboard. If all the previous steps were completed successfully, PayPal will activate your account within 48 hours.

You can now proceed with the integration. This depends on how you have integrated Razorpay on your website or application.

By default, your PayPal account will only be configured to receive USD payments. You can enable more currencies on your account from your PayPal Dashboard.

Standard Checkout Integration#

If you are using Razorpay Standard Checkout, you just need to enable Paypal from your dashboard and complete the onboarding procedure.

Once the onboarding is completed and PayPal is enabled for you, it appears on your checkout form for all supported currencies.

Custom Checkout Integration#

If you are using Razorpay Custom Checkout, you just need to enable Paypal from your dashboard and complete the onboarding procedure.

Once the onboarding is completed, you need to make changes to your checkout form UI to display PayPal as a payment option.

When creating a payment, internally, you should call the payment method wallet, with the provider as paypal.

Copyrazorpay.createPayment({ amount: 5000, email: 'gaurav.kumar@example.com', contact: '9123456780', order_id: 'order_1A00000000001a', method: 'wallet', wallet: 'paypal' });

Supported Currencies#

By default your Paypal account will only be configured to receive USD payments. You can enable more currencies on your account from your Paypal dashboard.

Settlements#

Payments made using PayPal are directly settled to your PayPal wallet.

Refunds#

PayPal Balance Required
Ensure you have sufficient balance in your PayPal account before you initiate a refund.

Refunds can be initiated by you either from the Razorpay Dashboard or from using the Refunds API.

The refund amount is deducted from your PayPal account and credited to your customer's PayPal account.

×