Connecting PayPal
PayPal is part of the core Sunshine Photo Cart plugin and lets your customers pay with their PayPal account, Venmo, Pay Later, and the other payment options PayPal offers in their country. It has no platform fees.
A PayPal Business Account is required, personal accounts will not work. If you only have a personal account, see PayPal Legacy below.
Connecting PayPal
Sunshine connects to PayPal using REST API credentials: a Client ID and a Secret. These are long codes you create in the PayPal Developer Dashboard.
Important: the Client ID and Secret are not your PayPal login email, your account username, or the API username/password/signature from PayPal's older (NVP/SOAP) API. Entering any of those instead of a REST API Client ID will stop the PayPal button from loading at checkout.
Where to get your Client ID and Secret
- Go to the PayPal Developer Dashboard → Apps & Credentials and log in with your PayPal Business account.
- Make sure the Live toggle is selected (use Sandbox only for testing).
- Under Apps & Credentials, open an existing app or click Create App to make one.
- Copy the Client ID and click Show under the Secret Key to copy the Secret.
- In WordPress, go to Sunshine > Settings > Payments, turn on PayPal with the toggle switch and click Configure.
- Set the Mode to Live, and paste each value into the matching field.
If you need PayPal's own walkthrough for creating an app, see PayPal's instructions.
When copying the credentials, be sure you are matching Live to Live and Sandbox to Sandbox. If you put Sandbox API credentials into the Live fields, it will not work.

Enable the features you would like. For example:

To stop using PayPal, turn it off with the toggle switch in Sunshine > Settings > Payments. To use a different PayPal account, replace the Client ID and Secret with the ones from that account.
PayPal Settings
Along with the custom name and description shown at checkout, the PayPal settings let you choose how the PayPal buttons look and which payment options appear:
- Allow Venmo shows a Venmo button to customers who can use it
- Button Layout shows the buttons side by side (Horizontal) or stacked (Vertical)
- Color, Button Shape and Label change the look and wording of the PayPal button
- Tagline shows or hides the short line of text under horizontal buttons
- Hide funding sources hides payment options you don't want to offer, such as Pay Later or Venmo
What Your Customer Sees
At checkout, your customer chooses PayPal and clicks the PayPal button. A PayPal window opens where they log in and approve the payment. When they approve it, the window closes and Sunshine completes the order and shows their receipt.
If they close the PayPal window without paying, nothing is charged and they stay on your checkout page, where they can click the PayPal button again or choose another payment method. If PayPal can't take the payment, your customer sees PayPal's reason on the checkout page and can try again.
To get an email when a PayPal payment runs into trouble, like a payment that doesn't match the order total, turn on the Admin Payment Problem email in Sunshine > Settings > Emails. It's off until you turn it on. See Emails for more.
Refunds
You can refund a PayPal payment from your WordPress admin without logging into PayPal.
- Open the order in Sunshine > Orders
- In the Order Actions panel, choose Refund payment in PayPal
- Leave Full refund checked, or uncheck it and enter a partial amount
- Click Apply
The refund amount is recorded on the order and comes off its total. A full refund changes the order status to "Refunded". A partial refund keeps the order's current status. If PayPal reports the refund as pending, Sunshine records it on the order and shows a notice saying so. If PayPal turns the refund down, the notice shows PayPal's reason.
Testing PayPal
Set the Mode to Sandbox and enter the Sandbox Client ID and Sandbox Secret from the Sandbox side of the PayPal Developer Dashboard. While in Sandbox mode, your checkout shows a note that payments are only tests and no real money changes hands. See Test purchases with PayPal for how to set up test buyer accounts.
Switch the Mode back to Live when you're ready to take real payments.
PayPal Legacy
PayPal Legacy is a second, older PayPal option in Sunshine > Settings > Payments. It's only meant for photographers with a PayPal Personal account, which can't create the Client ID and Secret above. If you have a Business account, use the regular PayPal option instead.
To set it up:
- Go to Sunshine > Settings > Payments
- Turn on PayPal (Legacy) with the toggle switch and click Configure
- Set the Mode to Live
- Enter the Email address of your PayPal account
With PayPal Legacy, the checkout button reads Continue to PayPal. Your customer is sent to PayPal's website to pay, then brought back to their order on your site. PayPal tells your site about the payment in the background, and the order is marked paid once PayPal confirms the payment went to your account for the full order total. If the payment doesn't match, the order stays unpaid and a note is added to it (and the Admin Payment Problem email goes out, if you turned it on).
If your customer cancels on PayPal's website, they are sent back to your checkout page with a message that the payment was cancelled. That order is kept as Cancelled, and when they try again a new order is made.
PayPal Legacy doesn't have refunds from the order screen. Refund those payments in your PayPal account, then change the order status to Refunded in Sunshine.
Still need help?
If you have not yet found your answer in the documentation articles, please contact support