@paypal/checkout-components

PayPal Checkout

A set of components allowing easy integration of PayPal Buttons and PayPal Checkout into your site, powered by zoid.

---

HowTo Videos

Try it in our Demo App

Learn more in our Dev Docs

Upgrade your classic PayPal integration

Deep Dive in our YouTube Training

Demo App Source

---

Which Integration is right for me?

• Do you want the simplest possible PayPal Integration? If so, you should stick with the Basic PayPal Checkout Button which allows you to just drop a button straight into your page. This will allow your customer to pay with PayPal, and we'll notify you when they're done.

• Do you want a button which gives you finely grained control over your transaction; creating and finalizing transactions from your server side using PayPal's REST api? If so you should use the Advanced Javascript Integration, which will allow you to create and finalize the transaction yourself on your server side using the PayPal Payments REST API.

• Do you use React.js, Angular.js or Ember.js to render your page? If so, you should use the React.js, Angular.js or Ember.js Elements, which provide native support for each of these frameworks, so you can drop PayPal Buttons in any of your front-end views.

• Do you have a mark integration? In this case, you should look at the Mark Integration docs to decide how best to integrate PayPal Checkout

Create a PayPal REST Application

Usage

1. Add checkout.v4.js to your page:

   <script src="https://www.paypalobjects.com/api/checkout.js" data-version-4></script>
   

2. Drop the following component onto your page:

PayPal Checkout Button

This component renders a PayPal button onto your page, which will take care of opening up PayPal for you and guiding your customer through the payment process. After the payment is complete, we will notify you using a javascript callback, and you can take your customer to a success page.

Integrate the button component

---

Integrating with the PayPal REST API

If you want to use the advanced javascript integrations, you will need a way to create payment tokens on your server side. The simplest way to do this is using the PayPal Payments REST API

Integrating with the PayPal REST API

---

Development

Please feel free to follow the Contribution Guidelines to contribute to this repository. PRs are welcome, but for major changes please raise an issue first.

Quick Setup

Set up your env:

npm install -g flow-typed
npm install
flow-typed install

Run tests:

npm test

Build checkout.js:

npm run build

Debugging messages

To enable output of additional debugging messages to the console, set the data-log-level attribute of the script element to e.g. info (default value is warn):

<script src="https://www.paypalobjects.com/api/checkout.js" data-version-4 data-log-level="info"></script>

Test Tasks

npm test

Flags	Description
--clear-cache	Clear Babel Loader and PhantomJS cache
--debug	Debug mode. PhantomJS, Karma, and CheckoutJS
--quick	Fastest testing. Minimal output, no coverage
--browser	Choose Browser

Features

Here is a full list of features provided by this library

• Http (AJAX) Helper functions

Changelog

<small>4.1.38 (2018-12-13)</small>

• 4.1.38 (dfbe37a)
• Add implement checkout doc (0db368f)
• Do not send sdkMeta in window name to child (af6a167)
• Only allow iframe check on paypal domain (f333ed0)
• Use autoResize for buttons component (7ad008e)