PayPal Adaptive Payments

Note: This product is no longer sold on WooCommerce.com. This document was left available to you for help with configuration and troubleshooting, but is no longer updated.

PayPal Adaptive Payments handles payments between a sender of a payment and one or more receivers of the payment. It’s possible to split the order total with secondary receivers, so you can pay commissions or partners.

This extension supports:

Parallel payments

Enable a sender to send a single payment to multiple receivers (you + five receivers). For example, your shopping cart allows a buyer to pay for items from several merchants with one payment, then allocates payment to merchants that provided the items. PayPal deducts money from the sender’s account and deposits it in the receivers’ accounts.

Chained payments

Enable a sender to send a single payment to a primary receiver. The primary receiver keeps part of the payment and pays the remainder to (up to nine) secondary receivers.

For example, you’re an online travel agency that handles bookings for airfare, hotel reservations and car rentals. The sender only sees you as the primary receiver, and you allocate payment for your commission and the actual cost of services provided by other receivers. PayPal then deducts money from the sender’s account and deposits it in both your account and the secondary receivers’ accounts.

Simple payments

Enable a sender to send a single payment to a single receiver. For example, your website takes payment and transfers money from the customer’s PayPal account to your own, as a result of a sale. This is a traditional payment.

This work automatically when there are no other recipients or receivers.

1. Download the .zip file from your WooCommerce.com account.
2. Go to: WordPress Admin > Plugins > Add New to upload the file you downloaded with Choose File.
3. Activate the extension.

More information at: Installing and Managing Plugins.

You must have a PayPal Business or Premier account to generate APIs keys for this plugin. PayPal Adaptive Payments is a limited release product, subject to approval by PayPal.

1. Go to PayPal and sign up or log in.
2. Go to: Profile > Profile and settings > My selling tools
3. Click the Update link for API Access.

4. On API Access page, select Option 2 by clicking Request API credentials:

5. Select Request API signature and click the Agree and Submit button:

6. Copy your API data to use for Setup and Configuration (below).

1. Go to PayPal Developer, and log in.
2. Go to Dashboard, and click the My Apps & Credentials link.

3. Scroll down and click Manage NVP/SOAP API apps.

4. Click the New Application link.

5. Enter App Information, such as the Title and Description.

6. Select Web for the platform, and Adaptive Payments for Services used by app.

7. Click the Submit App button.

PayPal will review your app. When it is accepted, you will have access to your Live PayPal Application ID to use for Setup and Configuration (next).

1. Go to: WooCommerce > Settings > Payments.
   Note: ‘Payments’ formerly called ‘Checkout’ prior to WooCommerce 3.4.
2. Select PayPal Adaptive Payments. You are taken to the Settings screen.
   
3. Configure your settings:
   • Enable/Disable – Enable to use. Disable to turn off.
   • Title – Choose the title shown to customers during checkout
   • Description – Add info shown to customers if they use PayPal Adaptive
4. Enter API Credentials from your PayPal account
   • PayPal API Username
   • PayPal API Password
   • PayPal API Signature
   • PayPal Application ID
5. Payments
   • Enter the email address you use for PayPal payments in the Receiver Email field. This is important.
   • Payment Method – Select from the dropdown
   • Invoice Prefix (optional). This is helpful if you’re using the same PayPal account for more than one website/store.
6. Design – Enter the URL of an image (see Payment page customization below)
7. Gateway Testing
   • PayPal sandbox – Enable if in development or testing. Remember to disable when ready to go live.
   • Debug log – Enable if troubleshooting. Otherwise, leave disabled.
8. Save changes.

PayPal Adaptive sends customers to PayPal to complete payment. You can customize this page by including your own logo. Add the URL to the logo in the Header Image field. The recommended size is 70×950 pixels.

If you choose to leave blank the Header Image field, your site’s name (as set in WordPress settings) will be shown instead.

An example custom logo header is shown in the Customer Flow section.

All receivers of payment must be set up by entering their email addresses and the percentage they receive per sale in each Product they’re associated with.

1. Go to WooCommerce > Products, then the individual Product.
2. Scroll down to Product Data.
3. Go to the PayPal Adaptive Payments tab.
4. Enter the receiver’s email address and a percentage.

Enter each receiver’s email and the percentage (no % symbol), separated by a pipe (|). One receiver per line. For example:

• Only use other people’s email addresses, not your own. Your email is configured in the plugin options.
• Total percentage may not exceed 100%, The remainder is what you receive.

The payment process occurs as typical for a WooCommerce PayPal integration, and the PayPal Adaptive Payments plugin automatically sets up the refund and notification URLs for you.

In this example, the customer is checking out with a single £9 item that has been set up with a commission of 20% to ninja@email.com, 15% to sensei@email.com and the remainder to the shop owner.

The checkout option looks the same as any other PayPal payment gateway. In this example, the demo text has been added to show that it really is the PayPal Adaptive gateway:

The customer is sent to PayPal to complete the payment. The Custom Logo field has a logo that is 90×750 pixels.

The customer is prompted to choose the payment method and click Pay:

Once payment has been completed successfully, the customer is returned to the WooCommerce site and shown the default order confirmation page:

You can dynamically assign receivers using the woocommerce_paypal_ap_payment_args filter. For example:

For recurring payments, no. For manual payments, yes. The only way to use Adaptive Payments with WooCommerce Subscriptions would be to have manual subscriptions set up.

Have a question before you buy? Please fill out this pre-sales form.

Already purchased and need some assistance? Get in touch with a Happiness Engineer via the Help Desk.