0.3.1

bugfix: add missing subscription properties
docs: add dispute and reversal webhooks to quickstart
2025-12-23 22:08:46 +00:00 · 2021-10-23 16:09:05 -06:00 · 2021-10-23 16:08:47 -06:00 · 2021-10-19 00:01:27 -06:00 · 2021-10-17 12:55:27 -06:00 · 2021-10-17 12:55:20 -06:00
13 changed files with 1392 additions and 524 deletions
--- a/README.md
+++ b/README.md
@ -17,38 +17,234 @@ The Good Documentation™ for the PayPal API (a.k.a. PayPal Checkout SDK) is the
  subscriptions)
 - <https://www.paypal.com/webapps/mpp/logos-buttons> (the buttons)

+# Table of Contents
+
+- Install
+- QuickStart
+  - Orders (One-Time Purchases)
+  - PayPal Checkout Buttons
+- REST API Overview
+  - Orders & Subscriptions
+  - Enums
+  - Redirects
+  - Webhooks
+- Security & Notes
+- Detailed Examples & Glossary
+
 # Install

 ```bash
 npm install --save @root/paypal-checkout
 ```

-# Usage
+Optional, for Type Linting and Auto-Complete

-```js
-"use strict";
-
-require("dotenv").config({ path: ".env" });
-
-let PPC = require("@root/paypal-checkout");
-PPC.init({
-  client_id: "xxxx",
-  client_secret: "****",
-});
-
-PPC.Subscriptions.createRequest({
-  // See https://developer.paypal.com/docs/api/subscriptions/v1/#subscriptions
-});
+```bash
+npm install --save @root/paypal-checkout-product-categories
 ```

-# API
+# Quick Start

-```txt
-PayPal.init(client_id, client_secret, 'sandbox|live', defaults);
+If you just want to create a "Buy Now" or "Checkout with PayPal" type of button,
+here's the gist of what you need to do:
+
+## Order (One-Time Purchase)
+
+1. Initialize the API
+
+   ```js
+   "use strict";
+
+   require("dotenv").config({ path: ".env" });
+
+   let PPC = require("@root/paypal-checkout");
+
+   PPC.init(
+     process.env.PAYPAL_CLIENT_ID || "xxxx",
+     process.env.PAYPAL_CLIENT_SECRET || "****",
+     "sandbox" || "live",
+     {
+       // default query params for endpoints that use them
+       prefer: "return=representation",
+       total_required: true,
+       page_size: 20,
+     }
+   );
+   ```
+
+2. Create a "Buy Now" link (for Approval)
+
+   ```js
+   // See https://developer.paypal.com/docs/api/orders/v2/#orders_create
+   let myApiUrl = "https://example.com";
+   let myOrderId = "local-db-id-for-user-purchasing-product";
+   let order = await PPC.Order.createRequest({
+     application_context: {
+       // What to show on PayPal's Pay Now page
+       brand_name: "Bliss via The Root Group, LLC",
+       shipping_preference: "NO_SHIPPING",
+       landing_page: "LOGIN",
+       user_action: PPC.Order.user_actions.PAY_NOW,
+       return_url: `${myApiUrl}/api/redirects/paypal-checkout/return`,
+       cancel_url: `${myApiUrl}/api/redirects/paypal-checkout/cancel`,
+     },
+     purchase_units: [
+       {
+         request_id: "default",
+         custom_id: myOrderId,
+         // shown in PayPal Checkout Flow UI
+         description: "1 year of pure Bliss",
+         // on the charge (credit card) statement
+         soft_descriptor: "Bliss",
+         amount: {
+           currency_code: "USD",
+           value: "10.00",
+         },
+       },
+     ],
+   });
+
+   console.info(
+     "Approve URL:",
+     order.links.find(function (link) {
+       return "approve" === link.rel;
+     }).href
+   );
+   ```
+
+3. Handle the redirect: Verify & Capture
+
+   ```js
+   app.get("/api/redirects/paypal-checkout/return", async function (req, res) {
+     let orderId = req.query.token;
+
+     // verify that the user has paid
+     await PPC.Order.details(orderId)
+       .then(async function (order) {
+         console.info("Deliver the Product to:", order.payer.email_address);
+         if ("APPROVED" !== order.status) {
+           throw new Error("spoofed redirect or cancelled order");
+         }
+
+         // take the money
+         let capture = await PPC.Order.capture(order.id, {
+           final_capture: true,
+         });
+       })
+       .catch(next);
+   });
+   ```
+
+4. [Set](https://developer.paypal.com/developer/applications) and Handle the
+   [`PAYMENT.CAPTURE.COMPLETED`, `PAYMENT.CAPTURE.REVERSED`, and `CUSTOMER.DISPUTE.CREATED`](https://developer.paypal.com/docs/api-basics/notifications/webhooks/event-names/)
+   WebHooks
+
+   ```js
+   // Set webhook at https://developer.paypal.com/developer/applications
+   // Descriptions at https://developer.paypal.com/docs/api-basics/notifications/webhooks/event-names/
+   app.get("/api/webhooks/paypal-checkout/:secret", async function (req, res) {
+     let crypto = require("crypto");
+     let secret = process.env.PAYPAL_WEBHOOK_SECRET || "";
+     let guess = req.params.secret;
+     if (
+       !secret ||
+       secret.length !== guess.length ||
+       !crypto.timingSafeEqual(Buffer.from(guess), Buffer.from(secret))
+     ) {
+       next(new Error("bad webhook secret value"));
+       return;
+     }
+
+     let event = req.body;
+     switch (event.event_type) {
+       case "PAYMENT.CAPTURE.COMPLETED":
+         {
+           let orderId = event.supplementary_data.related_ids.order_id;
+           let localDbId = event.custom_id;
+           console.info(
+             `Confirm that PayPal Order ${orderId} for ${localDbId} has been paid.`
+           );
+         }
+         break;
+       case "PAYMENT.CAPTURE.REVERSED":
+         {
+           // deduct from user's account
+         }
+         break;
+       case "CUSTOMER.DISPUTE.CREATED":
+         {
+           // TODO send email to merchant (myself) to check out the dispute
+         }
+         break;
+       case "CUSTOMER.DISPUTE.CREATED":
+         {
+           // TODO send email to merchant (myself) to review the dispute status
+         }
+         break;
+       default:
+         console.log("Ignoring", event.event_type);
+         res.json({ sucess: true });
+         return;
+     }
+   });
+   ```
+
+## PayPal Checkout Buttons
+
+- <https://www.paypal.com/webapps/mpp/logos-buttons> <== THE ONE YOU WANT
+  - <img src="https://www.paypalobjects.com/webstatic/en_US/i/buttons/checkout-logo-large.png" alt="Check out with PayPal" />
+- <https://developer.paypal.com/docs/checkout/>
+- <https://www.paypal.com/buttons/>
+
+# API Overview
+
+## Init
+
+```js
+PayPal.init(client_id, client_secret, "sandbox", defaults);
 PayPal.request({ method, url, headers, json });
 ```

-### Subscrptions (Recurring Payments)
+### No Dependencies Needed
+
+If you'd like to keep your code super lightweight, you don't even need an SDK -
+you can just use simple HTTP requests:
+
+```js
+let qs = require("querystring");
+let request = require("@root/request");
+let paypalApi = "https://api-m.sandbox.paypal.com";
+
+async function PayPalRequest(
+  endpoint = "/v2/checkout/orders",
+  query = { page_size: 20 },
+  body = { purchase_units: [] },
+  requestId // optional id for certain requests
+) {
+  let search = qs.stringify(query);
+
+  return await request({
+    url: `${paypalApi}${endpoint}?${search}`,
+    auth: {
+      user: process.env.PAYPAL_CLIENT_ID,
+      pass: process.env.PAYPAL_CLIENT_SECRET,
+    },
+    headers: {
+      "PayPal-Request-Id": requestId,
+    },
+    json: body,
+  }).then(function (resp) {
+    if (rsep.status < 200 || resp.status >= 300) {
+      throw new Error("BAD RESPONSE");
+    }
+    return resp.toJSON().body;
+  });
+}
+```
+
+## Subscriptions (Recurring Payments)
+
+See https://developer.paypal.com/docs/api/subscriptions/v1/#subscriptions

 ```txt
                                              // Webhook 'event_type':
@ -70,7 +266,7 @@ PayPal.Subscription.details(id);
 PayPal.Subscription.cancel(id, { reason });
 ```

-### Orders (One-Time Payments)
+## Orders (One-Time Payments)

 ```txt
                                                // Webhook 'event_type':
@ -85,12 +281,53 @@ See also:
 - <https://developer.paypal.com/docs/api/orders/v2/#definition-purchase_unit_request>
 - <https://developer.paypal.com/docs/api/orders/v2/#definition-order_application_context>

-# Redirects
+## Enums (optional)
+
+For assistance with Type Linting and Auto-Complete, all of the PayPal Checkout
+enums (ALL CAPS strings that have a limit set of allow values such as `PAY_NOW`
+and `CONTINUE`) are available in code.
+
+They are defined like this:
+
+```js
+Order.user_actions = {
+  CONTINUE: "CONTINUE",
+  PAY_NOW: "PAY_NOW",
+};
+```
+
+You can inspect them simply like this:
+
+```js
+console.log(Order.user_actions);
+```
+
+Here's the full list:
+
+```js
+PayPal.Order.intents;
+PayPal.Order.user_actions;
+PayPal.Order.shipping_preferences;
+PayPal.Plan.intervals;
+PayPal.Plan.tenures;
+PayPal.Product.categories; // See note below
+PayPal.Product.types;
+PayPal.Subscription.actions;
+PayPal.Subscription.payee_preferences;
+PayPal.Subscription.payer_selections;
+PayPal.Subscription.shipping_preferences;
+```
+
+The one exception is `PayPal.Product.categories` which provides only a limited
+set of generic values for simple products and services if
+`@root/paypal-checkout-product-categories` is not installed.
+
+## Redirects

 - `return_url`
 - `cancel_url`

-#### `return_url`
+### `return_url`

 **_Order_** and **_Subscription_** requests have a return `return_url` will be
 called with some or all of the following params:
@ -120,7 +357,7 @@ https://example.com/redirects/paypal-checkout/return
 - `token` refers to the **_Order ID_** (perhaps created as part of the setup fee
  or first billing cycle payment).

-#### `cancel_url`
+### `cancel_url`

 The `cancel_url` will have the same query params as the `return_url`.

@ -128,7 +365,7 @@ Also, PayPal presents the raw `cancel_url` and will NOT update the order or
 subscription status. It's up to you to confirm with the user and change the
 status to `CANCELLED`.

-# Webhooks
+## Webhooks

 Webhooks can be set up in the Application section of the Dashboard:

@ -185,12 +422,63 @@ Sandbox accounts (for creating fake purchases) can be managed at:

 You can auth once and capture multiple times (unless you set `final_capture`).

-## PayPal Checkout Buttons
+# Examples

- <https://www.paypal.com/webapps/mpp/logos-buttons> <== THE ONE YOU WANT
-  - <img src="https://www.paypalobjects.com/webstatic/en_US/i/buttons/checkout-logo-large.png" alt="Check out with PayPal" />
- <https://developer.paypal.com/docs/checkout/>
- <https://www.paypal.com/buttons/>
+### Subscription.createRequest({ ... })
+
+See
+https://developer.paypal.com/docs/subscriptions/integrate/#use-the-subscriptions-api
+
+```js
+await Subscription.createRequest({
+  plan_id: plan.id,
+  //start_time: "2018-11-01T00:00:00Z", (must be in the future)
+  //quantity: "20",
+  //shipping_amount: { currency_code: "USD", value: "10.00" },
+  subscriber: {
+    name: { given_name: "James", surname: "Doe" },
+    email_address: "customer@example.com",
+    /*
+      shipping_address: {
+        name: { full_name: "James Doe" },
+        address: {
+          address_line_1: "123 Sesame Street",
+          address_line_2: "Building 17",
+          admin_area_2: "San Jose",
+          admin_area_1: "CA",
+          postal_code: "95131",
+          country_code: "US",
+        },
+      },
+    */
+  },
+  application_context: {
+    brand_name: "Bliss via The Root Group, LLC",
+    locale: "en-US",
+    shipping_preference: Subscription.shipping_preferences.NO_SHIPPING,
+    user_action: Subscription.actions.SUBSCRIBE_NOW,
+    payment_method: {
+      payer_selected: Subscription.payer_selections.PAYPAL,
+      payee_preferred:
+        Subscription.payee_preferences.IMMEDIATE_PAYMENT_REQUIRED,
+    },
+    return_url:
+      "https://example.com/api/paypal-checkout/return?my_token=abc123",
+    cancel_url:
+      "https://example.com/api/paypal-checkout/cancel?my_token=abc123",
+  },
+});
+console.info("Subscription (Before Approval):");
+console.info(JSON.stringify(subscription, null, 2));
+console.info();
+
+console.info(
+  "Approve URL:",
+  subscription.links.find(function (link) {
+    return "approve" === link.rel;
+  }).href
+);
+```

 # Glossary

--- a/package-lock.json
+++ b/package-lock.json
@ -1,13 +1,13 @@
 {
  "name": "@root/paypal-checkout",
-  "version": "0.2.0",
+  "version": "0.3.1",
  "lockfileVersion": 2,
  "requires": true,
  "packages": {
    "": {
      "name": "@root/paypal-checkout",
-      "version": "0.2.0",
-      "license": "MPL-2.0",
+      "version": "0.3.1",
+      "license": "SEE LICENSE IN LICENSE",
      "dependencies": {
        "@root/request": "^1.7.0"
      },
--- a/package.json
+++ b/package.json
@ -1,13 +1,12 @@
 {
  "name": "@root/paypal-checkout",
-  "version": "0.2.0",
+  "version": "0.3.1",
  "description": "A more sensible, human-generated wrapper for the PayPal Checkout REST API",
  "main": "paypal-checkout.js",
  "files": [
    "lib"
  ],
  "scripts": {
-    "prepare": "node utils/make-categories.js",
    "test": "node test.js"
  },
  "repository": {
--- a/paypal-checkout.js
+++ b/paypal-checkout.js
@ -24,7 +24,7 @@ PayPal.init = function (client_id, client_secret, env, opts) {
  if ("live" === env) {
    PayPal.__baseUrl = PayPal.__liveApiBaseUrl;
  } else {
-    PayPal.__baseUrl = PayPal.__sandboxUrl;
+    PayPal.__baseUrl = PayPal.__sandboxApiBaseUrl;
    console.debug("[PayPal Checkout] ENVIRONMENT=sandbox");
  }
  PayPal.__id = client_id;
@ -120,11 +120,22 @@ function enumify(obj) {
 }
 */

+let shipping_preferences = {
+  GET_FROM_FILE: "GET_FROM_FILE", // provided, or selectable from PayPal addresses
+  SET_PROVIDED_ADDRESS: "SET_PROVIDED_ADDRESS", // user can't change it here
+  NO_SHIPPING: "NO_SHIPPING", // duh
+};
+
 let Order = {};
 Order.intents = {
  CAPTURE: "CAPTURE",
  AUTHORIZE: "AUTHORIZE",
 };
+Order.user_actions = {
+  CONTINUE: "CONTINUE",
+  PAY_NOW: "PAY_NOW",
+};
+Order.shipping_preferences = shipping_preferences;
 // See
 // https://developer.paypal.com/docs/api/orders/v2/#orders_create
 // https://developer.paypal.com/docs/api/orders/v2/#definition-purchase_unit_request
@ -195,16 +206,22 @@ Product.__typeNames = Object.keys(Product.types);

 // Documented under "categories" at
 // https://developer.paypal.com/docs/api/catalog-products/v1/
-Product.categories = require("./lib/categories.json");
+
+// Optionally load the full list
+// (for those that want the type linting)
+try {
+  // the full list
+  Product.categories = require("@root/paypal-checkout-product-categories");
+} catch {
+  // the short list
+  Product.categories = {
+    SOFTWARE: "SOFTWARE",
+    PHYSICAL_GOOD: "PHYSICAL_GOOD",
+    DIGITAL_MEDIA_BOOKS_MOVIES_MUSIC: "DIGITAL_MEDIA_BOOKS_MOVIES_MUSIC",
+    DIGITAL_GAMES: "DIGITAL_GAMES",
+  };
+}
 Product.__categoryNames = Object.keys(Product.categories);
-/*
-Product.categories = {
-  SOFTWARE: "SOFTWARE",
-  PHYSICAL_GOOD: "PHYSICAL_GOOD",
-  DIGITAL_MEDIA_BOOKS_MOVIES_MUSIC: "DIGITAL_MEDIA_BOOKS_MOVIES_MUSIC",
-  DIGITAL_GAMES: "DIGITAL_GAMES",
-};
-*/

 Product.create = async function _createProduct({
  request_id,
@ -299,6 +316,7 @@ Plan.intervals = {
  MONTH: "MONTH",
  YEAR: "YEAR",
 };
+
 Plan.tenures = {
  TRIAL: "TRIAL",
  REGULAR: "REGULAR",
@ -414,11 +432,7 @@ Subscription.actions = {
  CONTINUE: "CONTINUE",
  SUBSCRIBE_NOW: "SUBSCRIBE_NOW",
 };
-Subscription.shipping_preferences = {
-  GET_FROM_FILE: "GET_FROM_FILE", // provided, or selectable from PayPal addresses
-  SET_PROVIDED_ADDRESS: "SET_PROVIDED_ADDRESS", // user can't change it here
-  NO_SHIPPING: "NO_SHIPPING", // duh
-};
+Subscription.shipping_preferences = shipping_preferences;
 Subscription.payer_selections = {
  PAYPAL: "PAYPAL",
 };
@ -427,6 +441,7 @@ Subscription.payee_preferences = {
  IMMEDIATE_PAYMENT_REQUIRED: "IMMEDIATE_PAYMENT_REQUIRED",
 };

+// See https://developer.paypal.com/docs/api/subscriptions/v1/#subscriptions_create
 Subscription.createRequest = async function _createSubscription({
  request_id,
  plan_id,
@ -435,6 +450,8 @@ Subscription.createRequest = async function _createSubscription({
  shipping_amount,
  subscriber,
  application_context,
+  custom_id,
+  plan,
 }) {
  return await PayPal.request({
    method: "POST",
@ -482,6 +499,8 @@ Subscription.createRequest = async function _createSubscription({
 				}
      */
      application_context: application_context,
+      custom_id: custom_id,
+      plan: plan,
    },
  })
    .then(must201or200)
--- a/utils/make-categories.js
+++ b/utils/make-categories.js
@ -1,475 +0,0 @@
-// Documented under "categories" at
-// https://developer.paypal.com/docs/api/catalog-products/v1/
-/*
-  // To scrape the full list from the site:
-  var categories = [];
-  var $c = $$('.dax-def-label code').find(function ($el) {
-    if ("category" === $el.innerText.toLowerCase()) {
-      return $el;
-    }
-  });
-  $c.closest('div').nextElementSibling.querySelectorAll('li').forEach(function ($el) {
-    categories.push($el.querySelector('code').innerText);
-  });
-  console.info(JSON.stringify(categories));
-*/
-let categories = [
-  "AC_REFRIGERATION_REPAIR",
-  "ACADEMIC_SOFTWARE",
-  "ACCESSORIES",
-  "ACCOUNTING",
-  "ADULT",
-  "ADVERTISING",
-  "AFFILIATED_AUTO_RENTAL",
-  "AGENCIES",
-  "AGGREGATORS",
-  "AGRICULTURAL_COOPERATIVE_FOR_MAIL_ORDER",
-  "AIR_CARRIERS_AIRLINES",
-  "AIRLINES",
-  "AIRPORTS_FLYING_FIELDS",
-  "ALCOHOLIC_BEVERAGES",
-  "AMUSEMENT_PARKS_CARNIVALS",
-  "ANIMATION",
-  "ANTIQUES",
-  "APPLIANCES",
-  "AQUARIAMS_SEAQUARIUMS_DOLPHINARIUMS",
-  "ARCHITECTURAL_ENGINEERING_AND_SURVEYING_SERVICES",
-  "ART_AND_CRAFT_SUPPLIES",
-  "ART_DEALERS_AND_GALLERIES",
-  "ARTIFACTS_GRAVE_RELATED_AND_NATIVE_AMERICAN_CRAFTS",
-  "ARTS_AND_CRAFTS",
-  "ARTS_CRAFTS_AND_COLLECTIBLES",
-  "AUDIO_BOOKS",
-  "AUTO_ASSOCIATIONS_CLUBS",
-  "AUTO_DEALER_USED_ONLY",
-  "AUTO_RENTALS",
-  "AUTO_SERVICE",
-  "AUTOMATED_FUEL_DISPENSERS",
-  "AUTOMOBILE_ASSOCIATIONS",
-  "AUTOMOTIVE",
-  "AUTOMOTIVE_REPAIR_SHOPS_NON_DEALER",
-  "AUTOMOTIVE_TOP_AND_BODY_SHOPS",
-  "AVIATION",
-  "BABIES_CLOTHING_AND_SUPPLIES",
-  "BABY",
-  "BANDS_ORCHESTRAS_ENTERTAINERS",
-  "BARBIES",
-  "BATH_AND_BODY",
-  "BATTERIES",
-  "BEAN_BABIES",
-  "BEAUTY",
-  "BEAUTY_AND_FRAGRANCES",
-  "BED_AND_BATH",
-  "BICYCLE_SHOPS_SALES_AND_SERVICE",
-  "BICYCLES_AND_ACCESSORIES",
-  "BILLIARD_POOL_ESTABLISHMENTS",
-  "BOAT_DEALERS",
-  "BOAT_RENTALS_AND_LEASING",
-  "BOATING_SAILING_AND_ACCESSORIES",
-  "BOOKS",
-  "BOOKS_AND_MAGAZINES",
-  "BOOKS_MANUSCRIPTS",
-  "BOOKS_PERIODICALS_AND_NEWSPAPERS",
-  "BOWLING_ALLEYS",
-  "BULLETIN_BOARD",
-  "BUS_LINE",
-  "BUS_LINES_CHARTERS_TOUR_BUSES",
-  "BUSINESS",
-  "BUSINESS_AND_SECRETARIAL_SCHOOLS",
-  "BUYING_AND_SHOPPING_SERVICES_AND_CLUBS",
-  "CABLE_SATELLITE_AND_OTHER_PAY_TELEVISION_AND_RADIO_SERVICES",
-  "CABLE_SATELLITE_AND_OTHER_PAY_TV_AND_RADIO",
-  "CAMERA_AND_PHOTOGRAPHIC_SUPPLIES",
-  "CAMERAS",
-  "CAMERAS_AND_PHOTOGRAPHY",
-  "CAMPER_RECREATIONAL_AND_UTILITY_TRAILER_DEALERS",
-  "CAMPING_AND_OUTDOORS",
-  "CAMPING_AND_SURVIVAL",
-  "CAR_AND_TRUCK_DEALERS",
-  "CAR_AND_TRUCK_DEALERS_USED_ONLY",
-  "CAR_AUDIO_AND_ELECTRONICS",
-  "CAR_RENTAL_AGENCY",
-  "CATALOG_MERCHANT",
-  "CATALOG_RETAIL_MERCHANT",
-  "CATERING_SERVICES",
-  "CHARITY",
-  "CHECK_CASHIER",
-  "CHILD_CARE_SERVICES",
-  "CHILDREN_BOOKS",
-  "CHIROPODISTS_PODIATRISTS",
-  "CHIROPRACTORS",
-  "CIGAR_STORES_AND_STANDS",
-  "CIVIC_SOCIAL_FRATERNAL_ASSOCIATIONS",
-  "CIVIL_SOCIAL_FRAT_ASSOCIATIONS",
-  "CLOTHING",
-  "CLOTHING_ACCESSORIES_AND_SHOES",
-  "CLOTHING_RENTAL",
-  "COFFEE_AND_TEA",
-  "COIN_OPERATED_BANKS_AND_CASINOS",
-  "COLLECTIBLES",
-  "COLLECTION_AGENCY",
-  "COLLEGES_AND_UNIVERSITIES",
-  "COMMERCIAL_EQUIPMENT",
-  "COMMERCIAL_FOOTWEAR",
-  "COMMERCIAL_PHOTOGRAPHY",
-  "COMMERCIAL_PHOTOGRAPHY_ART_AND_GRAPHICS",
-  "COMMERCIAL_SPORTS_PROFESSIONA",
-  "COMMODITIES_AND_FUTURES_EXCHANGE",
-  "COMPUTER_AND_DATA_PROCESSING_SERVICES",
-  "COMPUTER_HARDWARE_AND_SOFTWARE",
-  "COMPUTER_MAINTENANCE_REPAIR_AND_SERVICES_NOT_ELSEWHERE_CLAS",
-  "CONSTRUCTION",
-  "CONSTRUCTION_MATERIALS_NOT_ELSEWHERE_CLASSIFIED",
-  "CONSULTING_SERVICES",
-  "CONSUMER_CREDIT_REPORTING_AGENCIES",
-  "CONVALESCENT_HOMES",
-  "COSMETIC_STORES",
-  "COUNSELING_SERVICES_DEBT_MARRIAGE_PERSONAL",
-  "COUNTERFEIT_CURRENCY_AND_STAMPS",
-  "COUNTERFEIT_ITEMS",
-  "COUNTRY_CLUBS",
-  "COURIER_SERVICES",
-  "COURIER_SERVICES_AIR_AND_GROUND_AND_FREIGHT_FORWARDERS",
-  "COURT_COSTS_ALIMNY_CHILD_SUPT",
-  "COURT_COSTS_INCLUDING_ALIMONY_AND_CHILD_SUPPORT_COURTS_OF_LAW",
-  "CREDIT_CARDS",
-  "CREDIT_UNION",
-  "CULTURE_AND_RELIGION",
-  "DAIRY_PRODUCTS_STORES",
-  "DANCE_HALLS_STUDIOS_AND_SCHOOLS",
-  "DECORATIVE",
-  "DENTAL",
-  "DENTISTS_AND_ORTHODONTISTS",
-  "DEPARTMENT_STORES",
-  "DESKTOP_PCS",
-  "DEVICES",
-  "DIECAST_TOYS_VEHICLES",
-  "DIGITAL_GAMES",
-  "DIGITAL_MEDIA_BOOKS_MOVIES_MUSIC",
-  "DIRECT_MARKETING",
-  "DIRECT_MARKETING_CATALOG_MERCHANT",
-  "DIRECT_MARKETING_INBOUND_TELE",
-  "DIRECT_MARKETING_OUTBOUND_TELE",
-  "DIRECT_MARKETING_SUBSCRIPTION",
-  "DISCOUNT_STORES",
-  "DOOR_TO_DOOR_SALES",
-  "DRAPERY_WINDOW_COVERING_AND_UPHOLSTERY",
-  "DRINKING_PLACES",
-  "DRUGSTORE",
-  "DURABLE_GOODS",
-  "ECOMMERCE_DEVELOPMENT",
-  "ECOMMERCE_SERVICES",
-  "EDUCATIONAL_AND_TEXTBOOKS",
-  "ELECTRIC_RAZOR_STORES",
-  "ELECTRICAL_AND_SMALL_APPLIANCE_REPAIR",
-  "ELECTRICAL_CONTRACTORS",
-  "ELECTRICAL_PARTS_AND_EQUIPMENT",
-  "ELECTRONIC_CASH",
-  "ELEMENTARY_AND_SECONDARY_SCHOOLS",
-  "EMPLOYMENT",
-  "ENTERTAINERS",
-  "ENTERTAINMENT_AND_MEDIA",
-  "EQUIP_TOOL_FURNITURE_AND_APPLIANCE_RENTAL_AND_LEASING",
-  "ESCROW",
-  "EVENT_AND_WEDDING_PLANNING",
-  "EXERCISE_AND_FITNESS",
-  "EXERCISE_EQUIPMENT",
-  "EXTERMINATING_AND_DISINFECTING_SERVICES",
-  "FABRICS_AND_SEWING",
-  "FAMILY_CLOTHING_STORES",
-  "FASHION_JEWELRY",
-  "FAST_FOOD_RESTAURANTS",
-  "FICTION_AND_NONFICTION",
-  "FINANCE_COMPANY",
-  "FINANCIAL_AND_INVESTMENT_ADVICE",
-  "FINANCIAL_INSTITUTIONS_MERCHANDISE_AND_SERVICES",
-  "FIREARM_ACCESSORIES",
-  "FIREARMS_WEAPONS_AND_KNIVES",
-  "FIREPLACE_AND_FIREPLACE_SCREENS",
-  "FIREWORKS",
-  "FISHING",
-  "FLORISTS",
-  "FLOWERS",
-  "FOOD_DRINK_AND_NUTRITION",
-  "FOOD_PRODUCTS",
-  "FOOD_RETAIL_AND_SERVICE",
-  "FRAGRANCES_AND_PERFUMES",
-  "FREEZER_AND_LOCKER_MEAT_PROVISIONERS",
-  "FUEL_DEALERS_FUEL_OIL_WOOD_AND_COAL",
-  "FUEL_DEALERS_NON_AUTOMOTIVE",
-  "FUNERAL_SERVICES_AND_CREMATORIES",
-  "FURNISHING_AND_DECORATING",
-  "FURNITURE",
-  "FURRIERS_AND_FUR_SHOPS",
-  "GADGETS_AND_OTHER_ELECTRONICS",
-  "GAMBLING",
-  "GAME_SOFTWARE",
-  "GAMES",
-  "GARDEN_SUPPLIES",
-  "GENERAL",
-  "GENERAL_CONTRACTORS",
-  "GENERAL_GOVERNMENT",
-  "GENERAL_SOFTWARE",
-  "GENERAL_TELECOM",
-  "GIFTS_AND_FLOWERS",
-  "GLASS_PAINT_AND_WALLPAPER_STORES",
-  "GLASSWARE_CRYSTAL_STORES",
-  "GOVERNMENT",
-  "GOVERNMENT_IDS_AND_LICENSES",
-  "GOVERNMENT_LICENSED_ON_LINE_CASINOS_ON_LINE_GAMBLING",
-  "GOVERNMENT_OWNED_LOTTERIES",
-  "GOVERNMENT_SERVICES",
-  "GRAPHIC_AND_COMMERCIAL_DESIGN",
-  "GREETING_CARDS",
-  "GROCERY_STORES_AND_SUPERMARKETS",
-  "HARDWARE_AND_TOOLS",
-  "HARDWARE_EQUIPMENT_AND_SUPPLIES",
-  "HAZARDOUS_RESTRICTED_AND_PERISHABLE_ITEMS",
-  "HEALTH_AND_BEAUTY_SPAS",
-  "HEALTH_AND_NUTRITION",
-  "HEALTH_AND_PERSONAL_CARE",
-  "HEARING_AIDS_SALES_AND_SUPPLIES",
-  "HEATING_PLUMBING_AC",
-  "HIGH_RISK_MERCHANT",
-  "HIRING_SERVICES",
-  "HOBBIES_TOYS_AND_GAMES",
-  "HOME_AND_GARDEN",
-  "HOME_AUDIO",
-  "HOME_DECOR",
-  "HOME_ELECTRONICS",
-  "HOSPITALS",
-  "HOTELS_MOTELS_INNS_RESORTS",
-  "HOUSEWARES",
-  "HUMAN_PARTS_AND_REMAINS",
-  "HUMOROUS_GIFTS_AND_NOVELTIES",
-  "HUNTING",
-  "IDS_LICENSES_AND_PASSPORTS",
-  "ILLEGAL_DRUGS_AND_PARAPHERNALIA",
-  "INDUSTRIAL",
-  "INDUSTRIAL_AND_MANUFACTURING_SUPPLIES",
-  "INSURANCE_AUTO_AND_HOME",
-  "INSURANCE_DIRECT",
-  "INSURANCE_LIFE_AND_ANNUITY",
-  "INSURANCE_SALES_UNDERWRITING",
-  "INSURANCE_UNDERWRITING_PREMIUMS",
-  "INTERNET_AND_NETWORK_SERVICES",
-  "INTRA_COMPANY_PURCHASES",
-  "LABORATORIES_DENTAL_MEDICAL",
-  "LANDSCAPING",
-  "LANDSCAPING_AND_HORTICULTURAL_SERVICES",
-  "LAUNDRY_CLEANING_SERVICES",
-  "LEGAL",
-  "LEGAL_SERVICES_AND_ATTORNEYS",
-  "LOCAL_DELIVERY_SERVICE",
-  "LOCKSMITH",
-  "LODGING_AND_ACCOMMODATIONS",
-  "LOTTERY_AND_CONTESTS",
-  "LUGGAGE_AND_LEATHER_GOODS",
-  "LUMBER_AND_BUILDING_MATERIALS",
-  "MAGAZINES",
-  "MAINTENANCE_AND_REPAIR_SERVICES",
-  "MAKEUP_AND_COSMETICS",
-  "MANUAL_CASH_DISBURSEMENTS",
-  "MASSAGE_PARLORS",
-  "MEDICAL",
-  "MEDICAL_AND_PHARMACEUTICAL",
-  "MEDICAL_CARE",
-  "MEDICAL_EQUIPMENT_AND_SUPPLIES",
-  "MEDICAL_SERVICES",
-  "MEETING_PLANNERS",
-  "MEMBERSHIP_CLUBS_AND_ORGANIZATIONS",
-  "MEMBERSHIP_COUNTRY_CLUBS_GOLF",
-  "MEMORABILIA",
-  "MEN_AND_BOY_CLOTHING_AND_ACCESSORY_STORES",
-  "MEN_CLOTHING",
-  "MERCHANDISE",
-  "METAPHYSICAL",
-  "MILITARIA",
-  "MILITARY_AND_CIVIL_SERVICE_UNIFORMS",
-  "MISC._AUTOMOTIVE_AIRCRAFT_AND_FARM_EQUIPMENT_DEALERS",
-  "MISC._GENERAL_MERCHANDISE",
-  "MISCELLANEOUS_GENERAL_SERVICES",
-  "MISCELLANEOUS_REPAIR_SHOPS_AND_RELATED_SERVICES",
-  "MODEL_KITS",
-  "MONEY_TRANSFER_MEMBER_FINANCIAL_INSTITUTION",
-  "MONEY_TRANSFER_MERCHANT",
-  "MOTION_PICTURE_THEATERS",
-  "MOTOR_FREIGHT_CARRIERS_AND_TRUCKING",
-  "MOTOR_HOME_AND_RECREATIONAL_VEHICLE_RENTAL",
-  "MOTOR_HOMES_DEALERS",
-  "MOTOR_VEHICLE_SUPPLIES_AND_NEW_PARTS",
-  "MOTORCYCLE_DEALERS",
-  "MOTORCYCLES",
-  "MOVIE",
-  "MOVIE_TICKETS",
-  "MOVING_AND_STORAGE",
-  "MULTI_LEVEL_MARKETING",
-  "MUSIC_CDS_CASSETTES_AND_ALBUMS",
-  "MUSIC_STORE_INSTRUMENTS_AND_SHEET_MUSIC",
-  "NETWORKING",
-  "NEW_AGE",
-  "NEW_PARTS_AND_SUPPLIES_MOTOR_VEHICLE",
-  "NEWS_DEALERS_AND_NEWSTANDS",
-  "NON_DURABLE_GOODS",
-  "NON_FICTION",
-  "NON_PROFIT_POLITICAL_AND_RELIGION",
-  "NONPROFIT",
-  "NOVELTIES",
-  "OEM_SOFTWARE",
-  "OFFICE_SUPPLIES_AND_EQUIPMENT",
-  "ONLINE_DATING",
-  "ONLINE_GAMING",
-  "ONLINE_GAMING_CURRENCY",
-  "ONLINE_SERVICES",
-  "OOUTBOUND_TELEMARKETING_MERCH",
-  "OPHTHALMOLOGISTS_OPTOMETRIST",
-  "OPTICIANS_AND_DISPENSING",
-  "ORTHOPEDIC_GOODS_PROSTHETICS",
-  "OSTEOPATHS",
-  "OTHER",
-  "PACKAGE_TOUR_OPERATORS",
-  "PAINTBALL",
-  "PAINTS_VARNISHES_AND_SUPPLIES",
-  "PARKING_LOTS_AND_GARAGES",
-  "PARTS_AND_ACCESSORIES",
-  "PAWN_SHOPS",
-  "PAYCHECK_LENDER_OR_CASH_ADVANCE",
-  "PERIPHERALS",
-  "PERSONALIZED_GIFTS",
-  "PET_SHOPS_PET_FOOD_AND_SUPPLIES",
-  "PETROLEUM_AND_PETROLEUM_PRODUCTS",
-  "PETS_AND_ANIMALS",
-  "PHOTOFINISHING_LABORATORIES_PHOTO_DEVELOPING",
-  "PHOTOGRAPHIC_STUDIOS_PORTRAITS",
-  "PHOTOGRAPHY",
-  "PHYSICAL_GOOD",
-  "PICTURE_VIDEO_PRODUCTION",
-  "PIECE_GOODS_NOTIONS_AND_OTHER_DRY_GOODS",
-  "PLANTS_AND_SEEDS",
-  "PLUMBING_AND_HEATING_EQUIPMENTS_AND_SUPPLIES",
-  "POLICE_RELATED_ITEMS",
-  "POLITICAL_ORGANIZATIONS",
-  "POSTAL_SERVICES_GOVERNMENT_ONLY",
-  "POSTERS",
-  "PREPAID_AND_STORED_VALUE_CARDS",
-  "PRESCRIPTION_DRUGS",
-  "PROMOTIONAL_ITEMS",
-  "PUBLIC_WAREHOUSING_AND_STORAGE",
-  "PUBLISHING_AND_PRINTING",
-  "PUBLISHING_SERVICES",
-  "RADAR_DECTORS",
-  "RADIO_TELEVISION_AND_STEREO_REPAIR",
-  "REAL_ESTATE",
-  "REAL_ESTATE_AGENT",
-  "REAL_ESTATE_AGENTS_AND_MANAGERS_RENTALS",
-  "RELIGION_AND_SPIRITUALITY_FOR_PROFIT",
-  "RELIGIOUS",
-  "RELIGIOUS_ORGANIZATIONS",
-  "REMITTANCE",
-  "RENTAL_PROPERTY_MANAGEMENT",
-  "RESIDENTIAL",
-  "RETAIL",
-  "RETAIL_FINE_JEWELRY_AND_WATCHES",
-  "REUPHOLSTERY_AND_FURNITURE_REPAIR",
-  "RINGS",
-  "ROOFING_SIDING_SHEET_METAL",
-  "RUGS_AND_CARPETS",
-  "SCHOOLS_AND_COLLEGES",
-  "SCIENCE_FICTION",
-  "SCRAPBOOKING",
-  "SCULPTURES",
-  "SECURITIES_BROKERS_AND_DEALERS",
-  "SECURITY_AND_SURVEILLANCE",
-  "SECURITY_AND_SURVEILLANCE_EQUIPMENT",
-  "SECURITY_BROKERS_AND_DEALERS",
-  "SEMINARS",
-  "SERVICE_STATIONS",
-  "SERVICES",
-  "SEWING_NEEDLEWORK_FABRIC_AND_PIECE_GOODS_STORES",
-  "SHIPPING_AND_PACKING",
-  "SHOE_REPAIR_HAT_CLEANING",
-  "SHOE_STORES",
-  "SHOES",
-  "SNOWMOBILE_DEALERS",
-  "SOFTWARE",
-  "SPECIALTY_AND_MISC._FOOD_STORES",
-  "SPECIALTY_CLEANING_POLISHING_AND_SANITATION_PREPARATIONS",
-  "SPECIALTY_OR_RARE_PETS",
-  "SPORT_GAMES_AND_TOYS",
-  "SPORTING_AND_RECREATIONAL_CAMPS",
-  "SPORTING_GOODS",
-  "SPORTS_AND_OUTDOORS",
-  "SPORTS_AND_RECREATION",
-  "STAMP_AND_COIN",
-  "STATIONARY_PRINTING_AND_WRITING_PAPER",
-  "STENOGRAPHIC_AND_SECRETARIAL_SUPPORT_SERVICES",
-  "STOCKS_BONDS_SECURITIES_AND_RELATED_CERTIFICATES",
-  "STORED_VALUE_CARDS",
-  "SUPPLIES",
-  "SUPPLIES_AND_TOYS",
-  "SURVEILLANCE_EQUIPMENT",
-  "SWIMMING_POOLS_AND_SPAS",
-  "SWIMMING_POOLS_SALES_SUPPLIES_SERVICES",
-  "TAILORS_AND_ALTERATIONS",
-  "TAX_PAYMENTS",
-  "TAX_PAYMENTS_GOVERNMENT_AGENCIES",
-  "TAXICABS_AND_LIMOUSINES",
-  "TELECOMMUNICATION_SERVICES",
-  "TELEPHONE_CARDS",
-  "TELEPHONE_EQUIPMENT",
-  "TELEPHONE_SERVICES",
-  "THEATER",
-  "TIRE_RETREADING_AND_REPAIR",
-  "TOLL_OR_BRIDGE_FEES",
-  "TOOLS_AND_EQUIPMENT",
-  "TOURIST_ATTRACTIONS_AND_EXHIBITS",
-  "TOWING_SERVICE",
-  "TOYS_AND_GAMES",
-  "TRADE_AND_VOCATIONAL_SCHOOLS",
-  "TRADEMARK_INFRINGEMENT",
-  "TRAILER_PARKS_AND_CAMPGROUNDS",
-  "TRAINING_SERVICES",
-  "TRANSPORTATION_SERVICES",
-  "TRAVEL",
-  "TRUCK_AND_UTILITY_TRAILER_RENTALS",
-  "TRUCK_STOP",
-  "TYPESETTING_PLATE_MAKING_AND_RELATED_SERVICES",
-  "USED_MERCHANDISE_AND_SECONDHAND_STORES",
-  "USED_PARTS_MOTOR_VEHICLE",
-  "UTILITIES",
-  "UTILITIES_ELECTRIC_GAS_WATER_SANITARY",
-  "VARIETY_STORES",
-  "VEHICLE_SALES",
-  "VEHICLE_SERVICE_AND_ACCESSORIES",
-  "VIDEO_EQUIPMENT",
-  "VIDEO_GAME_ARCADES_ESTABLISH",
-  "VIDEO_GAMES_AND_SYSTEMS",
-  "VIDEO_TAPE_RENTAL_STORES",
-  "VINTAGE_AND_COLLECTIBLE_VEHICLES",
-  "VINTAGE_AND_COLLECTIBLES",
-  "VITAMINS_AND_SUPPLEMENTS",
-  "VOCATIONAL_AND_TRADE_SCHOOLS",
-  "WATCH_CLOCK_AND_JEWELRY_REPAIR",
-  "WEB_HOSTING_AND_DESIGN",
-  "WELDING_REPAIR",
-  "WHOLESALE_CLUBS",
-  "WHOLESALE_FLORIST_SUPPLIERS",
-  "WHOLESALE_PRESCRIPTION_DRUGS",
-  "WILDLIFE_PRODUCTS",
-  "WIRE_TRANSFER",
-  "WIRE_TRANSFER_AND_MONEY_ORDER",
-  "WOMEN_ACCESSORY_SPECIALITY",
-  "WOMEN_CLOTHING",
-];
-
-let Fs = require("fs");
-let categoriesMap = categories.reduce(function (obj, name) {
-  obj[name] = name;
-  return obj;
-}, {});
-Fs.mkdirSync(__dirname + "/../lib", { recursive: true });
-Fs.writeFileSync(
-  __dirname + "/../lib/categories.json",
-  JSON.stringify(categoriesMap, null, 2),
-  "utf8"
-);
--- a/vendor/product-categories/.gitignore
+++ b/vendor/product-categories/.gitignore
@ -0,0 +1 @@
+categories.js
--- a/vendor/product-categories/README.md
+++ b/vendor/product-categories/README.md
@ -0,0 +1,498 @@
+# [@root/paypal-checkout-product-categories](https://github.com/therootcompany/paypal-checkout.js/tree/main/vendor/product-categories/)
+
+Providing for those who like type linting, auto-complete, and want the full list
+of all PayPal Checkout categories (though these are not PayPal-specific - they
+are common across the industry).
+
+(this was removed from `@root/paypal-checkout` because it added a lot of package
+weight for something that very few people will need or use)
+
+## License
+
+SPDX: `(CC0-1.0 OR MIT)`
+
+| 🧑 Personal & Evaluation | 🧑‍💻 Professional | 🧑‍💼 Business | 🏢 Enterprise Support |
+| :----------------------: | :----------------: | :------------: | :-------------------: |
+|           Free           |        Free        |      Free      |          N/A          |
+
+## Install
+
+```bash
+npm install --save @root/paypal-checkout-product-categories
+```
+
+## Usage
+
+When installed, these will automatically be loaded into
+`@rootl/paypal-checkout`.
+
+```js
+"use strict";
+
+let PayPalCheckout = require("@root/paypal-checkout");
+
+PayPalCheckout.Product.categories.SOFTWARE; // "SOFTWARE"
+```
+
+They can also be used standalone:
+
+```js
+"use strict";
+
+let ProductCategories = require("@root/paypal-checkout-product-categories");
+
+ProductCategories.SOFTWARE; // "SOFTWARE"
+```
+
+## Full list
+
+Scraped from <https://developer.paypal.com/docs/api/catalog-products/v1/>.
+
+```txt
+AC_REFRIGERATION_REPAIR
+ACADEMIC_SOFTWARE
+ACCESSORIES
+ACCOUNTING
+ADULT
+ADVERTISING
+AFFILIATED_AUTO_RENTAL
+AGENCIES
+AGGREGATORS
+AGRICULTURAL_COOPERATIVE_FOR_MAIL_ORDER
+AIR_CARRIERS_AIRLINES
+AIRLINES
+AIRPORTS_FLYING_FIELDS
+ALCOHOLIC_BEVERAGES
+AMUSEMENT_PARKS_CARNIVALS
+ANIMATION
+ANTIQUES
+APPLIANCES
+AQUARIAMS_SEAQUARIUMS_DOLPHINARIUMS
+ARCHITECTURAL_ENGINEERING_AND_SURVEYING_SERVICES
+ART_AND_CRAFT_SUPPLIES
+ART_DEALERS_AND_GALLERIES
+ARTIFACTS_GRAVE_RELATED_AND_NATIVE_AMERICAN_CRAFTS
+ARTS_AND_CRAFTS
+ARTS_CRAFTS_AND_COLLECTIBLES
+AUDIO_BOOKS
+AUTO_ASSOCIATIONS_CLUBS
+AUTO_DEALER_USED_ONLY
+AUTO_RENTALS
+AUTO_SERVICE
+AUTOMATED_FUEL_DISPENSERS
+AUTOMOBILE_ASSOCIATIONS
+AUTOMOTIVE
+AUTOMOTIVE_REPAIR_SHOPS_NON_DEALER
+AUTOMOTIVE_TOP_AND_BODY_SHOPS
+AVIATION
+BABIES_CLOTHING_AND_SUPPLIES
+BABY
+BANDS_ORCHESTRAS_ENTERTAINERS
+BARBIES
+BATH_AND_BODY
+BATTERIES
+BEAN_BABIES
+BEAUTY
+BEAUTY_AND_FRAGRANCES
+BED_AND_BATH
+BICYCLE_SHOPS_SALES_AND_SERVICE
+BICYCLES_AND_ACCESSORIES
+BILLIARD_POOL_ESTABLISHMENTS
+BOAT_DEALERS
+BOAT_RENTALS_AND_LEASING
+BOATING_SAILING_AND_ACCESSORIES
+BOOKS
+BOOKS_AND_MAGAZINES
+BOOKS_MANUSCRIPTS
+BOOKS_PERIODICALS_AND_NEWSPAPERS
+BOWLING_ALLEYS
+BULLETIN_BOARD
+BUS_LINE
+BUS_LINES_CHARTERS_TOUR_BUSES
+BUSINESS
+BUSINESS_AND_SECRETARIAL_SCHOOLS
+BUYING_AND_SHOPPING_SERVICES_AND_CLUBS
+CABLE_SATELLITE_AND_OTHER_PAY_TELEVISION_AND_RADIO_SERVICES
+CABLE_SATELLITE_AND_OTHER_PAY_TV_AND_RADIO
+CAMERA_AND_PHOTOGRAPHIC_SUPPLIES
+CAMERAS
+CAMERAS_AND_PHOTOGRAPHY
+CAMPER_RECREATIONAL_AND_UTILITY_TRAILER_DEALERS
+CAMPING_AND_OUTDOORS
+CAMPING_AND_SURVIVAL
+CAR_AND_TRUCK_DEALERS
+CAR_AND_TRUCK_DEALERS_USED_ONLY
+CAR_AUDIO_AND_ELECTRONICS
+CAR_RENTAL_AGENCY
+CATALOG_MERCHANT
+CATALOG_RETAIL_MERCHANT
+CATERING_SERVICES
+CHARITY
+CHECK_CASHIER
+CHILD_CARE_SERVICES
+CHILDREN_BOOKS
+CHIROPODISTS_PODIATRISTS
+CHIROPRACTORS
+CIGAR_STORES_AND_STANDS
+CIVIC_SOCIAL_FRATERNAL_ASSOCIATIONS
+CIVIL_SOCIAL_FRAT_ASSOCIATIONS
+CLOTHING
+CLOTHING_ACCESSORIES_AND_SHOES
+CLOTHING_RENTAL
+COFFEE_AND_TEA
+COIN_OPERATED_BANKS_AND_CASINOS
+COLLECTIBLES
+COLLECTION_AGENCY
+COLLEGES_AND_UNIVERSITIES
+COMMERCIAL_EQUIPMENT
+COMMERCIAL_FOOTWEAR
+COMMERCIAL_PHOTOGRAPHY
+COMMERCIAL_PHOTOGRAPHY_ART_AND_GRAPHICS
+COMMERCIAL_SPORTS_PROFESSIONA
+COMMODITIES_AND_FUTURES_EXCHANGE
+COMPUTER_AND_DATA_PROCESSING_SERVICES
+COMPUTER_HARDWARE_AND_SOFTWARE
+COMPUTER_MAINTENANCE_REPAIR_AND_SERVICES_NOT_ELSEWHERE_CLAS
+CONSTRUCTION
+CONSTRUCTION_MATERIALS_NOT_ELSEWHERE_CLASSIFIED
+CONSULTING_SERVICES
+CONSUMER_CREDIT_REPORTING_AGENCIES
+CONVALESCENT_HOMES
+COSMETIC_STORES
+COUNSELING_SERVICES_DEBT_MARRIAGE_PERSONAL
+COUNTERFEIT_CURRENCY_AND_STAMPS
+COUNTERFEIT_ITEMS
+COUNTRY_CLUBS
+COURIER_SERVICES
+COURIER_SERVICES_AIR_AND_GROUND_AND_FREIGHT_FORWARDERS
+COURT_COSTS_ALIMNY_CHILD_SUPT
+COURT_COSTS_INCLUDING_ALIMONY_AND_CHILD_SUPPORT_COURTS_OF_LAW
+CREDIT_CARDS
+CREDIT_UNION
+CULTURE_AND_RELIGION
+DAIRY_PRODUCTS_STORES
+DANCE_HALLS_STUDIOS_AND_SCHOOLS
+DECORATIVE
+DENTAL
+DENTISTS_AND_ORTHODONTISTS
+DEPARTMENT_STORES
+DESKTOP_PCS
+DEVICES
+DIECAST_TOYS_VEHICLES
+DIGITAL_GAMES
+DIGITAL_MEDIA_BOOKS_MOVIES_MUSIC
+DIRECT_MARKETING
+DIRECT_MARKETING_CATALOG_MERCHANT
+DIRECT_MARKETING_INBOUND_TELE
+DIRECT_MARKETING_OUTBOUND_TELE
+DIRECT_MARKETING_SUBSCRIPTION
+DISCOUNT_STORES
+DOOR_TO_DOOR_SALES
+DRAPERY_WINDOW_COVERING_AND_UPHOLSTERY
+DRINKING_PLACES
+DRUGSTORE
+DURABLE_GOODS
+ECOMMERCE_DEVELOPMENT
+ECOMMERCE_SERVICES
+EDUCATIONAL_AND_TEXTBOOKS
+ELECTRIC_RAZOR_STORES
+ELECTRICAL_AND_SMALL_APPLIANCE_REPAIR
+ELECTRICAL_CONTRACTORS
+ELECTRICAL_PARTS_AND_EQUIPMENT
+ELECTRONIC_CASH
+ELEMENTARY_AND_SECONDARY_SCHOOLS
+EMPLOYMENT
+ENTERTAINERS
+ENTERTAINMENT_AND_MEDIA
+EQUIP_TOOL_FURNITURE_AND_APPLIANCE_RENTAL_AND_LEASING
+ESCROW
+EVENT_AND_WEDDING_PLANNING
+EXERCISE_AND_FITNESS
+EXERCISE_EQUIPMENT
+EXTERMINATING_AND_DISINFECTING_SERVICES
+FABRICS_AND_SEWING
+FAMILY_CLOTHING_STORES
+FASHION_JEWELRY
+FAST_FOOD_RESTAURANTS
+FICTION_AND_NONFICTION
+FINANCE_COMPANY
+FINANCIAL_AND_INVESTMENT_ADVICE
+FINANCIAL_INSTITUTIONS_MERCHANDISE_AND_SERVICES
+FIREARM_ACCESSORIES
+FIREARMS_WEAPONS_AND_KNIVES
+FIREPLACE_AND_FIREPLACE_SCREENS
+FIREWORKS
+FISHING
+FLORISTS
+FLOWERS
+FOOD_DRINK_AND_NUTRITION
+FOOD_PRODUCTS
+FOOD_RETAIL_AND_SERVICE
+FRAGRANCES_AND_PERFUMES
+FREEZER_AND_LOCKER_MEAT_PROVISIONERS
+FUEL_DEALERS_FUEL_OIL_WOOD_AND_COAL
+FUEL_DEALERS_NON_AUTOMOTIVE
+FUNERAL_SERVICES_AND_CREMATORIES
+FURNISHING_AND_DECORATING
+FURNITURE
+FURRIERS_AND_FUR_SHOPS
+GADGETS_AND_OTHER_ELECTRONICS
+GAMBLING
+GAME_SOFTWARE
+GAMES
+GARDEN_SUPPLIES
+GENERAL
+GENERAL_CONTRACTORS
+GENERAL_GOVERNMENT
+GENERAL_SOFTWARE
+GENERAL_TELECOM
+GIFTS_AND_FLOWERS
+GLASS_PAINT_AND_WALLPAPER_STORES
+GLASSWARE_CRYSTAL_STORES
+GOVERNMENT
+GOVERNMENT_IDS_AND_LICENSES
+GOVERNMENT_LICENSED_ON_LINE_CASINOS_ON_LINE_GAMBLING
+GOVERNMENT_OWNED_LOTTERIES
+GOVERNMENT_SERVICES
+GRAPHIC_AND_COMMERCIAL_DESIGN
+GREETING_CARDS
+GROCERY_STORES_AND_SUPERMARKETS
+HARDWARE_AND_TOOLS
+HARDWARE_EQUIPMENT_AND_SUPPLIES
+HAZARDOUS_RESTRICTED_AND_PERISHABLE_ITEMS
+HEALTH_AND_BEAUTY_SPAS
+HEALTH_AND_NUTRITION
+HEALTH_AND_PERSONAL_CARE
+HEARING_AIDS_SALES_AND_SUPPLIES
+HEATING_PLUMBING_AC
+HIGH_RISK_MERCHANT
+HIRING_SERVICES
+HOBBIES_TOYS_AND_GAMES
+HOME_AND_GARDEN
+HOME_AUDIO
+HOME_DECOR
+HOME_ELECTRONICS
+HOSPITALS
+HOTELS_MOTELS_INNS_RESORTS
+HOUSEWARES
+HUMAN_PARTS_AND_REMAINS
+HUMOROUS_GIFTS_AND_NOVELTIES
+HUNTING
+IDS_LICENSES_AND_PASSPORTS
+ILLEGAL_DRUGS_AND_PARAPHERNALIA
+INDUSTRIAL
+INDUSTRIAL_AND_MANUFACTURING_SUPPLIES
+INSURANCE_AUTO_AND_HOME
+INSURANCE_DIRECT
+INSURANCE_LIFE_AND_ANNUITY
+INSURANCE_SALES_UNDERWRITING
+INSURANCE_UNDERWRITING_PREMIUMS
+INTERNET_AND_NETWORK_SERVICES
+INTRA_COMPANY_PURCHASES
+LABORATORIES_DENTAL_MEDICAL
+LANDSCAPING
+LANDSCAPING_AND_HORTICULTURAL_SERVICES
+LAUNDRY_CLEANING_SERVICES
+LEGAL
+LEGAL_SERVICES_AND_ATTORNEYS
+LOCAL_DELIVERY_SERVICE
+LOCKSMITH
+LODGING_AND_ACCOMMODATIONS
+LOTTERY_AND_CONTESTS
+LUGGAGE_AND_LEATHER_GOODS
+LUMBER_AND_BUILDING_MATERIALS
+MAGAZINES
+MAINTENANCE_AND_REPAIR_SERVICES
+MAKEUP_AND_COSMETICS
+MANUAL_CASH_DISBURSEMENTS
+MASSAGE_PARLORS
+MEDICAL
+MEDICAL_AND_PHARMACEUTICAL
+MEDICAL_CARE
+MEDICAL_EQUIPMENT_AND_SUPPLIES
+MEDICAL_SERVICES
+MEETING_PLANNERS
+MEMBERSHIP_CLUBS_AND_ORGANIZATIONS
+MEMBERSHIP_COUNTRY_CLUBS_GOLF
+MEMORABILIA
+MEN_AND_BOY_CLOTHING_AND_ACCESSORY_STORES
+MEN_CLOTHING
+MERCHANDISE
+METAPHYSICAL
+MILITARIA
+MILITARY_AND_CIVIL_SERVICE_UNIFORMS
+MISC._AUTOMOTIVE_AIRCRAFT_AND_FARM_EQUIPMENT_DEALERS
+MISC._GENERAL_MERCHANDISE
+MISCELLANEOUS_GENERAL_SERVICES
+MISCELLANEOUS_REPAIR_SHOPS_AND_RELATED_SERVICES
+MODEL_KITS
+MONEY_TRANSFER_MEMBER_FINANCIAL_INSTITUTION
+MONEY_TRANSFER_MERCHANT
+MOTION_PICTURE_THEATERS
+MOTOR_FREIGHT_CARRIERS_AND_TRUCKING
+MOTOR_HOME_AND_RECREATIONAL_VEHICLE_RENTAL
+MOTOR_HOMES_DEALERS
+MOTOR_VEHICLE_SUPPLIES_AND_NEW_PARTS
+MOTORCYCLE_DEALERS
+MOTORCYCLES
+MOVIE
+MOVIE_TICKETS
+MOVING_AND_STORAGE
+MULTI_LEVEL_MARKETING
+MUSIC_CDS_CASSETTES_AND_ALBUMS
+MUSIC_STORE_INSTRUMENTS_AND_SHEET_MUSIC
+NETWORKING
+NEW_AGE
+NEW_PARTS_AND_SUPPLIES_MOTOR_VEHICLE
+NEWS_DEALERS_AND_NEWSTANDS
+NON_DURABLE_GOODS
+NON_FICTION
+NON_PROFIT_POLITICAL_AND_RELIGION
+NONPROFIT
+NOVELTIES
+OEM_SOFTWARE
+OFFICE_SUPPLIES_AND_EQUIPMENT
+ONLINE_DATING
+ONLINE_GAMING
+ONLINE_GAMING_CURRENCY
+ONLINE_SERVICES
+OOUTBOUND_TELEMARKETING_MERCH
+OPHTHALMOLOGISTS_OPTOMETRIST
+OPTICIANS_AND_DISPENSING
+ORTHOPEDIC_GOODS_PROSTHETICS
+OSTEOPATHS
+OTHER
+PACKAGE_TOUR_OPERATORS
+PAINTBALL
+PAINTS_VARNISHES_AND_SUPPLIES
+PARKING_LOTS_AND_GARAGES
+PARTS_AND_ACCESSORIES
+PAWN_SHOPS
+PAYCHECK_LENDER_OR_CASH_ADVANCE
+PERIPHERALS
+PERSONALIZED_GIFTS
+PET_SHOPS_PET_FOOD_AND_SUPPLIES
+PETROLEUM_AND_PETROLEUM_PRODUCTS
+PETS_AND_ANIMALS
+PHOTOFINISHING_LABORATORIES_PHOTO_DEVELOPING
+PHOTOGRAPHIC_STUDIOS_PORTRAITS
+PHOTOGRAPHY
+PHYSICAL_GOOD
+PICTURE_VIDEO_PRODUCTION
+PIECE_GOODS_NOTIONS_AND_OTHER_DRY_GOODS
+PLANTS_AND_SEEDS
+PLUMBING_AND_HEATING_EQUIPMENTS_AND_SUPPLIES
+POLICE_RELATED_ITEMS
+POLITICAL_ORGANIZATIONS
+POSTAL_SERVICES_GOVERNMENT_ONLY
+POSTERS
+PREPAID_AND_STORED_VALUE_CARDS
+PRESCRIPTION_DRUGS
+PROMOTIONAL_ITEMS
+PUBLIC_WAREHOUSING_AND_STORAGE
+PUBLISHING_AND_PRINTING
+PUBLISHING_SERVICES
+RADAR_DECTORS
+RADIO_TELEVISION_AND_STEREO_REPAIR
+REAL_ESTATE
+REAL_ESTATE_AGENT
+REAL_ESTATE_AGENTS_AND_MANAGERS_RENTALS
+RELIGION_AND_SPIRITUALITY_FOR_PROFIT
+RELIGIOUS
+RELIGIOUS_ORGANIZATIONS
+REMITTANCE
+RENTAL_PROPERTY_MANAGEMENT
+RESIDENTIAL
+RETAIL
+RETAIL_FINE_JEWELRY_AND_WATCHES
+REUPHOLSTERY_AND_FURNITURE_REPAIR
+RINGS
+ROOFING_SIDING_SHEET_METAL
+RUGS_AND_CARPETS
+SCHOOLS_AND_COLLEGES
+SCIENCE_FICTION
+SCRAPBOOKING
+SCULPTURES
+SECURITIES_BROKERS_AND_DEALERS
+SECURITY_AND_SURVEILLANCE
+SECURITY_AND_SURVEILLANCE_EQUIPMENT
+SECURITY_BROKERS_AND_DEALERS
+SEMINARS
+SERVICE_STATIONS
+SERVICES
+SEWING_NEEDLEWORK_FABRIC_AND_PIECE_GOODS_STORES
+SHIPPING_AND_PACKING
+SHOE_REPAIR_HAT_CLEANING
+SHOE_STORES
+SHOES
+SNOWMOBILE_DEALERS
+SOFTWARE
+SPECIALTY_AND_MISC._FOOD_STORES
+SPECIALTY_CLEANING_POLISHING_AND_SANITATION_PREPARATIONS
+SPECIALTY_OR_RARE_PETS
+SPORT_GAMES_AND_TOYS
+SPORTING_AND_RECREATIONAL_CAMPS
+SPORTING_GOODS
+SPORTS_AND_OUTDOORS
+SPORTS_AND_RECREATION
+STAMP_AND_COIN
+STATIONARY_PRINTING_AND_WRITING_PAPER
+STENOGRAPHIC_AND_SECRETARIAL_SUPPORT_SERVICES
+STOCKS_BONDS_SECURITIES_AND_RELATED_CERTIFICATES
+STORED_VALUE_CARDS
+SUPPLIES
+SUPPLIES_AND_TOYS
+SURVEILLANCE_EQUIPMENT
+SWIMMING_POOLS_AND_SPAS
+SWIMMING_POOLS_SALES_SUPPLIES_SERVICES
+TAILORS_AND_ALTERATIONS
+TAX_PAYMENTS
+TAX_PAYMENTS_GOVERNMENT_AGENCIES
+TAXICABS_AND_LIMOUSINES
+TELECOMMUNICATION_SERVICES
+TELEPHONE_CARDS
+TELEPHONE_EQUIPMENT
+TELEPHONE_SERVICES
+THEATER
+TIRE_RETREADING_AND_REPAIR
+TOLL_OR_BRIDGE_FEES
+TOOLS_AND_EQUIPMENT
+TOURIST_ATTRACTIONS_AND_EXHIBITS
+TOWING_SERVICE
+TOYS_AND_GAMES
+TRADE_AND_VOCATIONAL_SCHOOLS
+TRADEMARK_INFRINGEMENT
+TRAILER_PARKS_AND_CAMPGROUNDS
+TRAINING_SERVICES
+TRANSPORTATION_SERVICES
+TRAVEL
+TRUCK_AND_UTILITY_TRAILER_RENTALS
+TRUCK_STOP
+TYPESETTING_PLATE_MAKING_AND_RELATED_SERVICES
+USED_MERCHANDISE_AND_SECONDHAND_STORES
+USED_PARTS_MOTOR_VEHICLE
+UTILITIES
+UTILITIES_ELECTRIC_GAS_WATER_SANITARY
+VARIETY_STORES
+VEHICLE_SALES
+VEHICLE_SERVICE_AND_ACCESSORIES
+VIDEO_EQUIPMENT
+VIDEO_GAME_ARCADES_ESTABLISH
+VIDEO_GAMES_AND_SYSTEMS
+VIDEO_TAPE_RENTAL_STORES
+VINTAGE_AND_COLLECTIBLE_VEHICLES
+VINTAGE_AND_COLLECTIBLES
+VITAMINS_AND_SUPPLEMENTS
+VOCATIONAL_AND_TRADE_SCHOOLS
+WATCH_CLOCK_AND_JEWELRY_REPAIR
+WEB_HOSTING_AND_DESIGN
+WELDING_REPAIR
+WHOLESALE_CLUBS
+WHOLESALE_FLORIST_SUPPLIERS
+WHOLESALE_PRESCRIPTION_DRUGS
+WILDLIFE_PRODUCTS
+WIRE_TRANSFER
+WIRE_TRANSFER_AND_MONEY_ORDER
+WOMEN_ACCESSORY_SPECIALITY
+WOMEN_CLOTHING
+```
--- a/vendor/product-categories/build.js
+++ b/vendor/product-categories/build.js
@ -0,0 +1,45 @@
+// Documented under "categories" at
+// https://developer.paypal.com/docs/api/catalog-products/v1/
+/*
+  // To scrape the full list from the site:
+  var categories = [];
+  var $c = $$('.dax-def-label code').find(function ($el) {
+    if ("category" === $el.innerText.toLowerCase()) {
+      return $el;
+    }
+  });
+  $c.closest('div').nextElementSibling.querySelectorAll('li').forEach(function ($el) {
+    categories.push($el.querySelector('code').innerText);
+  });
+  console.info(JSON.stringify(categories));
+*/
+
+let Fs = require("fs");
+let Path = require("path");
+
+let categories = Fs.readFileSync(Path.join(__dirname, "categories.txt"), 'utf8')
+  .split(/[\n\r\s]/)
+  .filter(Boolean);
+
+let categoriesMap = categories.reduce(function (obj, name) {
+  obj[name] = name;
+  return obj;
+}, {});
+//Fs.mkdirSync(Path.join(__dirname,  "../lib"), { recursive: true });
+let categoriesJson = JSON.stringify(categoriesMap, null, 2).replace(
+  /"(\w+)":.*/g,
+  "$1: \"\","
+);
+Fs.writeFileSync(
+  Path.join(__dirname, "categories.js"),
+  `"use strict";
+
+module.exports = ${categoriesJson};
+
+// set the value to be the same string as the key
+Object.keys(module.exports).forEach(function (k) {
+  module.exports[k] = k;
+});
+`,
+  "utf8"
+);
--- a/vendor/product-categories/categories.txt
+++ b/vendor/product-categories/categories.txt
@ -0,0 +1,446 @@
+AC_REFRIGERATION_REPAIR
+ACADEMIC_SOFTWARE
+ACCESSORIES
+ACCOUNTING
+ADULT
+ADVERTISING
+AFFILIATED_AUTO_RENTAL
+AGENCIES
+AGGREGATORS
+AGRICULTURAL_COOPERATIVE_FOR_MAIL_ORDER
+AIR_CARRIERS_AIRLINES
+AIRLINES
+AIRPORTS_FLYING_FIELDS
+ALCOHOLIC_BEVERAGES
+AMUSEMENT_PARKS_CARNIVALS
+ANIMATION
+ANTIQUES
+APPLIANCES
+AQUARIAMS_SEAQUARIUMS_DOLPHINARIUMS
+ARCHITECTURAL_ENGINEERING_AND_SURVEYING_SERVICES
+ART_AND_CRAFT_SUPPLIES
+ART_DEALERS_AND_GALLERIES
+ARTIFACTS_GRAVE_RELATED_AND_NATIVE_AMERICAN_CRAFTS
+ARTS_AND_CRAFTS
+ARTS_CRAFTS_AND_COLLECTIBLES
+AUDIO_BOOKS
+AUTO_ASSOCIATIONS_CLUBS
+AUTO_DEALER_USED_ONLY
+AUTO_RENTALS
+AUTO_SERVICE
+AUTOMATED_FUEL_DISPENSERS
+AUTOMOBILE_ASSOCIATIONS
+AUTOMOTIVE
+AUTOMOTIVE_REPAIR_SHOPS_NON_DEALER
+AUTOMOTIVE_TOP_AND_BODY_SHOPS
+AVIATION
+BABIES_CLOTHING_AND_SUPPLIES
+BABY
+BANDS_ORCHESTRAS_ENTERTAINERS
+BARBIES
+BATH_AND_BODY
+BATTERIES
+BEAN_BABIES
+BEAUTY
+BEAUTY_AND_FRAGRANCES
+BED_AND_BATH
+BICYCLE_SHOPS_SALES_AND_SERVICE
+BICYCLES_AND_ACCESSORIES
+BILLIARD_POOL_ESTABLISHMENTS
+BOAT_DEALERS
+BOAT_RENTALS_AND_LEASING
+BOATING_SAILING_AND_ACCESSORIES
+BOOKS
+BOOKS_AND_MAGAZINES
+BOOKS_MANUSCRIPTS
+BOOKS_PERIODICALS_AND_NEWSPAPERS
+BOWLING_ALLEYS
+BULLETIN_BOARD
+BUS_LINE
+BUS_LINES_CHARTERS_TOUR_BUSES
+BUSINESS
+BUSINESS_AND_SECRETARIAL_SCHOOLS
+BUYING_AND_SHOPPING_SERVICES_AND_CLUBS
+CABLE_SATELLITE_AND_OTHER_PAY_TELEVISION_AND_RADIO_SERVICES
+CABLE_SATELLITE_AND_OTHER_PAY_TV_AND_RADIO
+CAMERA_AND_PHOTOGRAPHIC_SUPPLIES
+CAMERAS
+CAMERAS_AND_PHOTOGRAPHY
+CAMPER_RECREATIONAL_AND_UTILITY_TRAILER_DEALERS
+CAMPING_AND_OUTDOORS
+CAMPING_AND_SURVIVAL
+CAR_AND_TRUCK_DEALERS
+CAR_AND_TRUCK_DEALERS_USED_ONLY
+CAR_AUDIO_AND_ELECTRONICS
+CAR_RENTAL_AGENCY
+CATALOG_MERCHANT
+CATALOG_RETAIL_MERCHANT
+CATERING_SERVICES
+CHARITY
+CHECK_CASHIER
+CHILD_CARE_SERVICES
+CHILDREN_BOOKS
+CHIROPODISTS_PODIATRISTS
+CHIROPRACTORS
+CIGAR_STORES_AND_STANDS
+CIVIC_SOCIAL_FRATERNAL_ASSOCIATIONS
+CIVIL_SOCIAL_FRAT_ASSOCIATIONS
+CLOTHING
+CLOTHING_ACCESSORIES_AND_SHOES
+CLOTHING_RENTAL
+COFFEE_AND_TEA
+COIN_OPERATED_BANKS_AND_CASINOS
+COLLECTIBLES
+COLLECTION_AGENCY
+COLLEGES_AND_UNIVERSITIES
+COMMERCIAL_EQUIPMENT
+COMMERCIAL_FOOTWEAR
+COMMERCIAL_PHOTOGRAPHY
+COMMERCIAL_PHOTOGRAPHY_ART_AND_GRAPHICS
+COMMERCIAL_SPORTS_PROFESSIONA
+COMMODITIES_AND_FUTURES_EXCHANGE
+COMPUTER_AND_DATA_PROCESSING_SERVICES
+COMPUTER_HARDWARE_AND_SOFTWARE
+COMPUTER_MAINTENANCE_REPAIR_AND_SERVICES_NOT_ELSEWHERE_CLAS
+CONSTRUCTION
+CONSTRUCTION_MATERIALS_NOT_ELSEWHERE_CLASSIFIED
+CONSULTING_SERVICES
+CONSUMER_CREDIT_REPORTING_AGENCIES
+CONVALESCENT_HOMES
+COSMETIC_STORES
+COUNSELING_SERVICES_DEBT_MARRIAGE_PERSONAL
+COUNTERFEIT_CURRENCY_AND_STAMPS
+COUNTERFEIT_ITEMS
+COUNTRY_CLUBS
+COURIER_SERVICES
+COURIER_SERVICES_AIR_AND_GROUND_AND_FREIGHT_FORWARDERS
+COURT_COSTS_ALIMNY_CHILD_SUPT
+COURT_COSTS_INCLUDING_ALIMONY_AND_CHILD_SUPPORT_COURTS_OF_LAW
+CREDIT_CARDS
+CREDIT_UNION
+CULTURE_AND_RELIGION
+DAIRY_PRODUCTS_STORES
+DANCE_HALLS_STUDIOS_AND_SCHOOLS
+DECORATIVE
+DENTAL
+DENTISTS_AND_ORTHODONTISTS
+DEPARTMENT_STORES
+DESKTOP_PCS
+DEVICES
+DIECAST_TOYS_VEHICLES
+DIGITAL_GAMES
+DIGITAL_MEDIA_BOOKS_MOVIES_MUSIC
+DIRECT_MARKETING
+DIRECT_MARKETING_CATALOG_MERCHANT
+DIRECT_MARKETING_INBOUND_TELE
+DIRECT_MARKETING_OUTBOUND_TELE
+DIRECT_MARKETING_SUBSCRIPTION
+DISCOUNT_STORES
+DOOR_TO_DOOR_SALES
+DRAPERY_WINDOW_COVERING_AND_UPHOLSTERY
+DRINKING_PLACES
+DRUGSTORE
+DURABLE_GOODS
+ECOMMERCE_DEVELOPMENT
+ECOMMERCE_SERVICES
+EDUCATIONAL_AND_TEXTBOOKS
+ELECTRIC_RAZOR_STORES
+ELECTRICAL_AND_SMALL_APPLIANCE_REPAIR
+ELECTRICAL_CONTRACTORS
+ELECTRICAL_PARTS_AND_EQUIPMENT
+ELECTRONIC_CASH
+ELEMENTARY_AND_SECONDARY_SCHOOLS
+EMPLOYMENT
+ENTERTAINERS
+ENTERTAINMENT_AND_MEDIA
+EQUIP_TOOL_FURNITURE_AND_APPLIANCE_RENTAL_AND_LEASING
+ESCROW
+EVENT_AND_WEDDING_PLANNING
+EXERCISE_AND_FITNESS
+EXERCISE_EQUIPMENT
+EXTERMINATING_AND_DISINFECTING_SERVICES
+FABRICS_AND_SEWING
+FAMILY_CLOTHING_STORES
+FASHION_JEWELRY
+FAST_FOOD_RESTAURANTS
+FICTION_AND_NONFICTION
+FINANCE_COMPANY
+FINANCIAL_AND_INVESTMENT_ADVICE
+FINANCIAL_INSTITUTIONS_MERCHANDISE_AND_SERVICES
+FIREARM_ACCESSORIES
+FIREARMS_WEAPONS_AND_KNIVES
+FIREPLACE_AND_FIREPLACE_SCREENS
+FIREWORKS
+FISHING
+FLORISTS
+FLOWERS
+FOOD_DRINK_AND_NUTRITION
+FOOD_PRODUCTS
+FOOD_RETAIL_AND_SERVICE
+FRAGRANCES_AND_PERFUMES
+FREEZER_AND_LOCKER_MEAT_PROVISIONERS
+FUEL_DEALERS_FUEL_OIL_WOOD_AND_COAL
+FUEL_DEALERS_NON_AUTOMOTIVE
+FUNERAL_SERVICES_AND_CREMATORIES
+FURNISHING_AND_DECORATING
+FURNITURE
+FURRIERS_AND_FUR_SHOPS
+GADGETS_AND_OTHER_ELECTRONICS
+GAMBLING
+GAME_SOFTWARE
+GAMES
+GARDEN_SUPPLIES
+GENERAL
+GENERAL_CONTRACTORS
+GENERAL_GOVERNMENT
+GENERAL_SOFTWARE
+GENERAL_TELECOM
+GIFTS_AND_FLOWERS
+GLASS_PAINT_AND_WALLPAPER_STORES
+GLASSWARE_CRYSTAL_STORES
+GOVERNMENT
+GOVERNMENT_IDS_AND_LICENSES
+GOVERNMENT_LICENSED_ON_LINE_CASINOS_ON_LINE_GAMBLING
+GOVERNMENT_OWNED_LOTTERIES
+GOVERNMENT_SERVICES
+GRAPHIC_AND_COMMERCIAL_DESIGN
+GREETING_CARDS
+GROCERY_STORES_AND_SUPERMARKETS
+HARDWARE_AND_TOOLS
+HARDWARE_EQUIPMENT_AND_SUPPLIES
+HAZARDOUS_RESTRICTED_AND_PERISHABLE_ITEMS
+HEALTH_AND_BEAUTY_SPAS
+HEALTH_AND_NUTRITION
+HEALTH_AND_PERSONAL_CARE
+HEARING_AIDS_SALES_AND_SUPPLIES
+HEATING_PLUMBING_AC
+HIGH_RISK_MERCHANT
+HIRING_SERVICES
+HOBBIES_TOYS_AND_GAMES
+HOME_AND_GARDEN
+HOME_AUDIO
+HOME_DECOR
+HOME_ELECTRONICS
+HOSPITALS
+HOTELS_MOTELS_INNS_RESORTS
+HOUSEWARES
+HUMAN_PARTS_AND_REMAINS
+HUMOROUS_GIFTS_AND_NOVELTIES
+HUNTING
+IDS_LICENSES_AND_PASSPORTS
+ILLEGAL_DRUGS_AND_PARAPHERNALIA
+INDUSTRIAL
+INDUSTRIAL_AND_MANUFACTURING_SUPPLIES
+INSURANCE_AUTO_AND_HOME
+INSURANCE_DIRECT
+INSURANCE_LIFE_AND_ANNUITY
+INSURANCE_SALES_UNDERWRITING
+INSURANCE_UNDERWRITING_PREMIUMS
+INTERNET_AND_NETWORK_SERVICES
+INTRA_COMPANY_PURCHASES
+LABORATORIES_DENTAL_MEDICAL
+LANDSCAPING
+LANDSCAPING_AND_HORTICULTURAL_SERVICES
+LAUNDRY_CLEANING_SERVICES
+LEGAL
+LEGAL_SERVICES_AND_ATTORNEYS
+LOCAL_DELIVERY_SERVICE
+LOCKSMITH
+LODGING_AND_ACCOMMODATIONS
+LOTTERY_AND_CONTESTS
+LUGGAGE_AND_LEATHER_GOODS
+LUMBER_AND_BUILDING_MATERIALS
+MAGAZINES
+MAINTENANCE_AND_REPAIR_SERVICES
+MAKEUP_AND_COSMETICS
+MANUAL_CASH_DISBURSEMENTS
+MASSAGE_PARLORS
+MEDICAL
+MEDICAL_AND_PHARMACEUTICAL
+MEDICAL_CARE
+MEDICAL_EQUIPMENT_AND_SUPPLIES
+MEDICAL_SERVICES
+MEETING_PLANNERS
+MEMBERSHIP_CLUBS_AND_ORGANIZATIONS
+MEMBERSHIP_COUNTRY_CLUBS_GOLF
+MEMORABILIA
+MEN_AND_BOY_CLOTHING_AND_ACCESSORY_STORES
+MEN_CLOTHING
+MERCHANDISE
+METAPHYSICAL
+MILITARIA
+MILITARY_AND_CIVIL_SERVICE_UNIFORMS
+MISC._AUTOMOTIVE_AIRCRAFT_AND_FARM_EQUIPMENT_DEALERS
+MISC._GENERAL_MERCHANDISE
+MISCELLANEOUS_GENERAL_SERVICES
+MISCELLANEOUS_REPAIR_SHOPS_AND_RELATED_SERVICES
+MODEL_KITS
+MONEY_TRANSFER_MEMBER_FINANCIAL_INSTITUTION
+MONEY_TRANSFER_MERCHANT
+MOTION_PICTURE_THEATERS
+MOTOR_FREIGHT_CARRIERS_AND_TRUCKING
+MOTOR_HOME_AND_RECREATIONAL_VEHICLE_RENTAL
+MOTOR_HOMES_DEALERS
+MOTOR_VEHICLE_SUPPLIES_AND_NEW_PARTS
+MOTORCYCLE_DEALERS
+MOTORCYCLES
+MOVIE
+MOVIE_TICKETS
+MOVING_AND_STORAGE
+MULTI_LEVEL_MARKETING
+MUSIC_CDS_CASSETTES_AND_ALBUMS
+MUSIC_STORE_INSTRUMENTS_AND_SHEET_MUSIC
+NETWORKING
+NEW_AGE
+NEW_PARTS_AND_SUPPLIES_MOTOR_VEHICLE
+NEWS_DEALERS_AND_NEWSTANDS
+NON_DURABLE_GOODS
+NON_FICTION
+NON_PROFIT_POLITICAL_AND_RELIGION
+NONPROFIT
+NOVELTIES
+OEM_SOFTWARE
+OFFICE_SUPPLIES_AND_EQUIPMENT
+ONLINE_DATING
+ONLINE_GAMING
+ONLINE_GAMING_CURRENCY
+ONLINE_SERVICES
+OOUTBOUND_TELEMARKETING_MERCH
+OPHTHALMOLOGISTS_OPTOMETRIST
+OPTICIANS_AND_DISPENSING
+ORTHOPEDIC_GOODS_PROSTHETICS
+OSTEOPATHS
+OTHER
+PACKAGE_TOUR_OPERATORS
+PAINTBALL
+PAINTS_VARNISHES_AND_SUPPLIES
+PARKING_LOTS_AND_GARAGES
+PARTS_AND_ACCESSORIES
+PAWN_SHOPS
+PAYCHECK_LENDER_OR_CASH_ADVANCE
+PERIPHERALS
+PERSONALIZED_GIFTS
+PET_SHOPS_PET_FOOD_AND_SUPPLIES
+PETROLEUM_AND_PETROLEUM_PRODUCTS
+PETS_AND_ANIMALS
+PHOTOFINISHING_LABORATORIES_PHOTO_DEVELOPING
+PHOTOGRAPHIC_STUDIOS_PORTRAITS
+PHOTOGRAPHY
+PHYSICAL_GOOD
+PICTURE_VIDEO_PRODUCTION
+PIECE_GOODS_NOTIONS_AND_OTHER_DRY_GOODS
+PLANTS_AND_SEEDS
+PLUMBING_AND_HEATING_EQUIPMENTS_AND_SUPPLIES
+POLICE_RELATED_ITEMS
+POLITICAL_ORGANIZATIONS
+POSTAL_SERVICES_GOVERNMENT_ONLY
+POSTERS
+PREPAID_AND_STORED_VALUE_CARDS
+PRESCRIPTION_DRUGS
+PROMOTIONAL_ITEMS
+PUBLIC_WAREHOUSING_AND_STORAGE
+PUBLISHING_AND_PRINTING
+PUBLISHING_SERVICES
+RADAR_DECTORS
+RADIO_TELEVISION_AND_STEREO_REPAIR
+REAL_ESTATE
+REAL_ESTATE_AGENT
+REAL_ESTATE_AGENTS_AND_MANAGERS_RENTALS
+RELIGION_AND_SPIRITUALITY_FOR_PROFIT
+RELIGIOUS
+RELIGIOUS_ORGANIZATIONS
+REMITTANCE
+RENTAL_PROPERTY_MANAGEMENT
+RESIDENTIAL
+RETAIL
+RETAIL_FINE_JEWELRY_AND_WATCHES
+REUPHOLSTERY_AND_FURNITURE_REPAIR
+RINGS
+ROOFING_SIDING_SHEET_METAL
+RUGS_AND_CARPETS
+SCHOOLS_AND_COLLEGES
+SCIENCE_FICTION
+SCRAPBOOKING
+SCULPTURES
+SECURITIES_BROKERS_AND_DEALERS
+SECURITY_AND_SURVEILLANCE
+SECURITY_AND_SURVEILLANCE_EQUIPMENT
+SECURITY_BROKERS_AND_DEALERS
+SEMINARS
+SERVICE_STATIONS
+SERVICES
+SEWING_NEEDLEWORK_FABRIC_AND_PIECE_GOODS_STORES
+SHIPPING_AND_PACKING
+SHOE_REPAIR_HAT_CLEANING
+SHOE_STORES
+SHOES
+SNOWMOBILE_DEALERS
+SOFTWARE
+SPECIALTY_AND_MISC._FOOD_STORES
+SPECIALTY_CLEANING_POLISHING_AND_SANITATION_PREPARATIONS
+SPECIALTY_OR_RARE_PETS
+SPORT_GAMES_AND_TOYS
+SPORTING_AND_RECREATIONAL_CAMPS
+SPORTING_GOODS
+SPORTS_AND_OUTDOORS
+SPORTS_AND_RECREATION
+STAMP_AND_COIN
+STATIONARY_PRINTING_AND_WRITING_PAPER
+STENOGRAPHIC_AND_SECRETARIAL_SUPPORT_SERVICES
+STOCKS_BONDS_SECURITIES_AND_RELATED_CERTIFICATES
+STORED_VALUE_CARDS
+SUPPLIES
+SUPPLIES_AND_TOYS
+SURVEILLANCE_EQUIPMENT
+SWIMMING_POOLS_AND_SPAS
+SWIMMING_POOLS_SALES_SUPPLIES_SERVICES
+TAILORS_AND_ALTERATIONS
+TAX_PAYMENTS
+TAX_PAYMENTS_GOVERNMENT_AGENCIES
+TAXICABS_AND_LIMOUSINES
+TELECOMMUNICATION_SERVICES
+TELEPHONE_CARDS
+TELEPHONE_EQUIPMENT
+TELEPHONE_SERVICES
+THEATER
+TIRE_RETREADING_AND_REPAIR
+TOLL_OR_BRIDGE_FEES
+TOOLS_AND_EQUIPMENT
+TOURIST_ATTRACTIONS_AND_EXHIBITS
+TOWING_SERVICE
+TOYS_AND_GAMES
+TRADE_AND_VOCATIONAL_SCHOOLS
+TRADEMARK_INFRINGEMENT
+TRAILER_PARKS_AND_CAMPGROUNDS
+TRAINING_SERVICES
+TRANSPORTATION_SERVICES
+TRAVEL
+TRUCK_AND_UTILITY_TRAILER_RENTALS
+TRUCK_STOP
+TYPESETTING_PLATE_MAKING_AND_RELATED_SERVICES
+USED_MERCHANDISE_AND_SECONDHAND_STORES
+USED_PARTS_MOTOR_VEHICLE
+UTILITIES
+UTILITIES_ELECTRIC_GAS_WATER_SANITARY
+VARIETY_STORES
+VEHICLE_SALES
+VEHICLE_SERVICE_AND_ACCESSORIES
+VIDEO_EQUIPMENT
+VIDEO_GAME_ARCADES_ESTABLISH
+VIDEO_GAMES_AND_SYSTEMS
+VIDEO_TAPE_RENTAL_STORES
+VINTAGE_AND_COLLECTIBLE_VEHICLES
+VINTAGE_AND_COLLECTIBLES
+VITAMINS_AND_SUPPLEMENTS
+VOCATIONAL_AND_TRADE_SCHOOLS
+WATCH_CLOCK_AND_JEWELRY_REPAIR
+WEB_HOSTING_AND_DESIGN
+WELDING_REPAIR
+WHOLESALE_CLUBS
+WHOLESALE_FLORIST_SUPPLIERS
+WHOLESALE_PRESCRIPTION_DRUGS
+WILDLIFE_PRODUCTS
+WIRE_TRANSFER
+WIRE_TRANSFER_AND_MONEY_ORDER
+WOMEN_ACCESSORY_SPECIALITY
+WOMEN_CLOTHING
--- a/vendor/product-categories/index.js
+++ b/vendor/product-categories/index.js
@ -0,0 +1,3 @@
+'use strict';
+
+module.exports = require('./categories.js');
--- a/vendor/product-categories/package-lock.json
+++ b/vendor/product-categories/package-lock.json
@ -0,0 +1,13 @@
+{
+  "name": "@root/paypal-checkout-product-categories",
+  "version": "1.0.0",
+  "lockfileVersion": 2,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "@root/paypal-checkout-product-categories",
+      "version": "1.0.0",
+      "license": "(CC0-1.0 OR MIT)"
+    }
+  }
+}
--- a/vendor/product-categories/package.json
+++ b/vendor/product-categories/package.json
@ -0,0 +1,23 @@
+{
+  "name": "@root/paypal-checkout-product-categories",
+  "version": "1.0.0",
+  "description": "Full list of product categories for Type Linting and Auto-Complete with @root/paypal-checkout",
+  "main": "index.js",
+  "files": ["categories.js"],
+  "scripts": {
+    "prepare": "node build.js",
+    "build": "node build.js",
+    "test": "node test.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/therootcompany/paypal-checkout.js.git"
+  },
+  "keywords": ["PayPal", "Checkout", "Product", "Categories", "API", "SDK"],
+  "author": "AJ ONeal <aj@therootcompany.com> (https://therootcompany.com/)",
+  "license": "(CC0-1.0 OR MIT)",
+  "bugs": {
+    "url": "https://github.com/therootcompany/paypal-checkout.js/issues"
+  },
+  "homepage": "https://github.com/therootcompany/paypal-checkout.js#readme"
+}
--- a/vendor/product-categories/test.js
+++ b/vendor/product-categories/test.js
@ -0,0 +1,8 @@
+"use strict";
+
+if ("SOFTWARE" !== require("./categories.js").SOFTWARE) {
+  console.error(`FAIL: SOFTWARE !== "SOFTWARE"`);
+  process.exit(1);
+}
+
+console.info("PASS");
Author	SHA1	Message	Date
AJ ONeal	f47523f56d	0.3.1	2021-10-23 16:09:05 -06:00
AJ ONeal	70da150599	bugfix: add missing subscription properties	2021-10-23 16:08:47 -06:00
AJ ONeal	3d18aa00de	docs: add dispute and reversal webhooks to quickstart	2021-10-19 00:01:27 -06:00
AJ ONeal	825e70df06	0.3.0	2021-10-17 12:55:27 -06:00
AJ ONeal	6ed6b9615a	refactor: move Product.categories into own package (to reduce rarely-used bloat)	2021-10-17 12:55:20 -06:00
AJ ONeal	d487d30447	0.2.2	2021-10-17 01:04:52 -06:00
AJ ONeal	5a5f8ad9c6	docs: improve readability	2021-10-17 01:04:49 -06:00
AJ ONeal	d7f0adb69d	docs: fix header formatting	2021-10-17 00:54:00 -06:00
AJ ONeal	c361837b1c	0.2.1	2021-10-17 00:51:19 -06:00
AJ ONeal	6e8aa2e09f	docs: ToC, more detail & examples	2021-10-17 00:51:12 -06:00
AJ ONeal	7466e8a28e	bugfix: correct typo in sandbox url var	2021-10-17 00:50:54 -06:00