Express Checkout is a fast, easy way for buyers to pay with PayPal. In Chargebee, PayPal Express Checkout is an additional payment method you can offer your customers.
To offer PayPal as a payment method, you'll need to set up PayPal Express Checkout as a payment method in Chargebee. Details about configuring PayPal in Chargebee are discussed in the later sections.
When users choose to pay using this method during checkout, they are redirected to the PayPal login page. After they authenticate their PayPal account, they are taken to the checkout page where they can confirm their Billing Information and then complete their orders. The Paypal Checkout Experience is discussed in detail in later sections.
Apart from the checkout pages, you can allow customers to choose PayPal as a payment method via the customer portal and also via Chargebee's secure Hosted Update Payment Method page.
When a customer subscribes to a product/service from your website for the first time and chooses to pay using PayPal Express Checkout, a PayPal Billing Agreement is created which has a Billing Agreement ID (BAID). Chargebee associates this Billing Agreement ID (BAID) with that customer. The Billing Agreement allows Chargebee to charge your customers automatically without them having to perform any action (such as logging into PayPal and approving the transaction) during each renewal. In addition, it can be used to pay one-time charges as well. The Billing Agreement does not expire unless the customer cancels it.
Chargebee uses the default payment method in the customer's PayPal account to charge them.
‘Reference Transactions' is a permission PayPal gives a merchant to collect recurring payment from your customer. Hence it is mandatory that you have reference transactions enabled in your PayPal Live Account.
This feature will not be enabled by default in your PayPal Sandbox Account.
To enable this feature, contact PayPal's Merchant Technical Support and specify the business account in which you would want this feature to be enabled.
In case you are not able to get it enabled, contact email@example.com.
Ensure that you have the following requirements in place to test PayPal Express Checkout in Chargebee's Test Site:
Chargebee's Test site makes use of PayPal Sandbox Business Account. Details about testing your PayPal Sandbox Business Account in Chargebee's Test site are discussed in later sections.
This is applicable if you would want Chargebee to copy billing address of customers from their PayPal accounts and pre-fill it in their checkout pages. To allow Chargebee to copy the Billing Address from PayPal, you should have the PayPal Billing Address Request feature enabled in your PayPal Sandbox Account. To enable this feature in your sandbox account, contact PayPal's Merchant Technical Support and specify the test business account in which you would want this feature to be enabled.
Ensure that you have configured the same list of currencies in both your PayPal Sandbox Account and your Chargebee Test Site. Find a list of currencies supported by both PayPal and Chargebee here.
Ensure that you have the following requirements in place for accepting payments via PayPal Express Checkout with Chargebee.
Please note that a PayPal Business Account is not the same as a PayPal Personal Account. Find more on the types of PayPal accounts here .
It is mandatory that you have reference transactions enabled in your PayPal Business Account. For this to be enabled in your live account, you will have to reach out to PayPal Customer Support and raise a request. Please note that PayPal has an approval process to enable reference transactions in your business account and this process usually takes some time.
This is applicable if you would want Chargebee to copy billing address of customers from their PayPal accounts and pre-fill it in their checkout pages. To allow Chargebee to copy the Billing Address from PayPal, you should have the PayPal Billing Address Request feature enabled in your PayPal Business Account. To enable this feature in your live account, contact PayPal Customer Support .
Ensure that you have configured the same list of currencies in both your PayPal Business Account and your Chargebee Live Site. Find a list of currencies supported by both PayPal and Chargebee here.
To set up PayPal Express Checkout, go to Settings > Configure Chargebee > Payment Gateways and click Add a Gateway.
Select PayPal Express Checkout from the list, this will take you to the configuration page.
Once you are on the configuration Page, follow these steps to configure PayPal Express Checkout,
To easily copy your API credentials, Click on the link Click here to easily copy your API credentials from PayPal which will redirect you to your PayPal login page, and once you login to your PayPal Business account all the API-related credentials will be displayed. If you are on Chargebee's Test site, clicking on this link will redirect you to the PayPal Sandbox site where you will have to login using your PayPal sandbox business credentials to easily copy the API credentials.
Copy the API Username, Password and the Signature from this list onto Chargebee.
Enter a short description of your product or service here. This description will show up under the Transaction Details section of your customers' PayPal account. For example, if your company Honey Comics, sells comic book subscriptions, the description could be Honey Comics - Comic Book Subscriptions. This description would enable your customers to easily identify transactions related to your company in their PayPal accounts.
Copy Shipping Address from PayPal : Select this option if you would prefer the Shipping Address from your customer's PayPal account to be pre-filled in the Checkout Page.
Copy Billing Address from PayPal : Select this option if you would prefer the Billing Address from your customer's PayPal account to be pre-filled in the Checkout Page.
To copy the Billing Address from PayPal, you should have the PayPal Billing Address Request feature enabled in your PayPal Business Account. To enable this feature in your live account, contact PayPal Customer Support. Enabling it in your PayPal Sandbox site requires approval from
Merchant Technical Support .
Trying to enable Copy Billing Address in Chargebee without enabling the PayPal Billing Address Request feature in your PayPal account would result in an error.
Your customers will still be able to edit their Shipping/Billing Addresses in the Checkout Page. However, the modified addresses will be saved only with Chargebee and not be updated in their PayPal Accounts.
Once the configurations are done, clicking on Configure PayPal would save your configurations and redirect you to the list of the gateways you have configured.
Instant Payment Notification (IPN) is a message service of PayPal that automatically notifies merchants of events related to PayPal transactions.
This service notifies various events related to PayPal transactions to a notification URL which is configured in PayPal. Once the notification URL provided by Chargebee is configured, it watches out for these transaction related events. Though Chargebee receives notifications related to all events, it reacts only to the Billing Agreement canceled event, by marking the PayPal Payment method associated with the customer as INVALID; resulting in the cancellation of the subscription upon renewal. Other operations performed directly in your PayPal account such as refunds, will not be reflected in Chargebee.
Say, your customer has canceled the Billing Agreement in their PayPal account, this is notified as an IPN message. Chargebee will receive this message via a notification URL and will then remove the corresponding billing agreement automatically. Hence, the customer will have to update their payment method to continue their subscription.
To configure IPN in your Chargebee dashboard, go to Settings > Configure Chargebee > Payment Gateways > PayPal Express Checkout and copy the Notification URL.
Now in your PayPal Business account, go to My Account > Profile > My Setting Tools > Instant payment notifications > Update > Choose IPN Settings, paste the copied notification URL and also enable the option Receive IPN messages.
Additionally, you need to ensure that PayPal encodes the information it sends across to Chargebee in a way that Chargebee can understand i.e. UTF-8. If the encoding differs, you might receive errors while using your IPN. To make sure you are using UTF-8 encoding, navigate to My Account > Profile > My Setting Tools > PayPal button language encoding > More Options and choose UTF-8 from the drop down menu. Here is a screenshot for reference:
If you are using Chargebee's test site, copy the notification URL from your test site and configure it in your PayPal SandBox Business Account.
If you have multiple live sites configured in Chargebee and all the live sites are mapped to the same PayPal Business Account, you will find multiple notification URLs in all your sites. However, in your PayPal Business Account, you can configure only a single IPN URL. In such cases, it will suffice if you configure any one of the notification URLs (from any Chargebee live site) in your PayPal Business Account. Chargebee smartly maps the IPN messages from all your Chargebee live sites to your PayPal Business Account. This is applicable for your test sites as well.
If you have enabled PayPal Express Checkout as a payment method for your customers, it will be available as a payment option while checking out, in the hosted pages.
After they choose the PayPal option, and click on Checkout with PayPal, they will be redirected to the PayPal login page.
Once they log in to PayPal, customers will see their PayPal account information being displayed along with the Billing Agreement Description which was configured in earlier steps. After they click on Agree and Continue, they will be redirected to their Order Summary Page in Chargebee. They can now verify their Orders and edit their Billing/Shipping Addresses as well if needed. The edited Shipping/Billing Addresses will be saved only with Chargebee and will not affect the ones saved in the customer's PayPal account.
The Payment Information section is displayed at the bottom of the checkout page. It contains the customer's email address associated with PayPal and also has a link which allows them to change their Payment Method if needed.
To accept payments via PayPal Express Checkout using your custom checkout page, here's the process to be followed in a nutshell:
Chargebee's Hosted Pages can still come to your rescue if you'd want to skip integrating with PayPal directly and quickly start accepting payments via PayPal.
Chargebee uses PayPal Express Checkout (Reference transactions) for capturing recurring payments.
Chargebee takes over from Step 4 (Capturing future payments) of the above process. Set up PayPal Express Checkout in your website by following Steps 1, 2, and 3 as mentioned in this document.
After you complete Step 3, you will have a Billing Agreement id which needs to be passed on to Chargebee.
When a customer authorizes a payment via PayPal for the first time, a billing
agreement is created. This generates a unique billing agreement id using which customers are charged for every future transaction.
The Billing Agreement id can be passed to Chargebee with the payment_method[reference_id] parameter, using any of the following APIs:
Chargebee then sends this billing agreement id to PayPal to validate it. After validation, the Billing Agreement id is stored at Chargebee's end and used to charge the customer for future payments.
Refer here for further information.
While creating a subscription for an existing customer, the option to specify the payment method information is not available. This is because, the payment method information is linked to customers and not the subscriptions.
It is recommended that you set up PayPal Express Checkout in Chargebee's Test site before setting it up in the Live Account.
"The PayPal Sandbox mirrors the features found on the PayPal production servers with minor limitations. By using fictitious Sandbox test accounts and their associated authentication credentials in your PayPal API calls, you can test and debug your application without referencing any real PayPal users or their live PayPal accounts." Read more about PayPal SandBox
PayPal SandBox environment provides virtual PayPal accounts for testing purposes.
They are of the following types:
It represents the merchant and mirrors the functionalities of a PayPal Business account.
It represents the customer and mirrors the functionalities of a PayPal Personal Account.
To access your PayPal SandBox Account, follow the steps given below,
Step 1: Login to the PayPal Developer Site using your PayPal Live Business Account credentials.
Step 2: Go to the Dashboard and click on Accounts under SandBox.
Step 3: PayPal creates two test accounts - one buyer test account and one business test account by default. If necessary, you can create multiple buyer and business accounts by clicking on "Create Account" as shown in the image below.
Step 4: Login to the test accounts created using the PayPal Sandbox Site . You can find the credentials to be used under the Profile section of the corresponding account as shown in the image below.
The following currencies are supported by both Chargebee and PayPal:
Additionally, the following currencies are supported only if you have a PayPal account in the corresponding country as mentioned:
1. I received an email from PayPal titled: "PayPal Instant Payment Notification Warning". What should I do about this?
Each IPN message sent from PayPal has to be acknowledged by Chargebee. If PayPal doesn't receive this acknowledgement, it treats the IPN as a failure and sends this email.
Check if you've configured the PayPal IPN as per instructions here and reach out to firstname.lastname@example.org with details, for further assistance.
2. How is the waiting period for refund handled in Chargebee if there is a delay?
Chargebee waits until 3-8 business days to check the status of the refund. In the meanwhile, the status of the refund in Chargebee will be in_progress.
When the refund is processed successfully from PayPal, Chargebee changes the refund status from in_progress to success and the related Credit Note will be marked as Refunded.