Skip to content
English
Need more help? Submit a request Customer portal
Go to app.sprii.io
  • There are no suggestions because the search field is empty.

Set up the PayPal integration

Configure live PayPal payments for a Sprii Checkout Page.

Before you start

Use a PayPal Business account and an administrator account for the intended Sprii Page. Set up Sprii Checkout first. This procedure uses a Live PayPal app.

Set it up

  1. In Sprii, select the Page and open Page settings Page settings selected in the Sprii menu > Sprii checkout > Payment methods Payment methods tab under Page settings > Sprii checkout. Find PayPal and click Configure.

    PayPal payment card with Configure
  2. Click Activate payment Activate payment button, then enter the customer-facing Title.
  3. Open the PayPal Developer Dashboard with your Business account. Open Apps & Credentials, then select Live.
  4. Open the intended Live app. If you need a new app, choose Create App, name it Sprii, and create it. Copy that Live app's Client ID and Secret. See PayPal’s app credential instructions.
  5. Return to Sprii and paste these values into client ID and secret.

    Paypal settings with blank Title, client ID and secret fields
  6. Before saving, make sure Sandbox is off in Sprii. If that checkbox is shown and checked, clear it. In the ordinary Page administrator view, it is hidden when Sandbox is off. Selecting Live in PayPal alone does not change this Sprii setting.
  7. Click Save Save button to keep the payment method for this Page.

Saving the settings does not confirm a payment, capture or payout.

Payment handling

The retained PayPal integration uses manual capture. Authorization, capture and settlement are separate; check the payment itself before shipping. PayPal owns approval, settlement and payout. A successful authorization can appear as Pending in PayPal; it is not the captured payment. After a successful capture, PayPal's transaction changes to Completed. This PayPal result is separate from a Sprii order being moved to Completed. See PayPal’s authorization and capture model.

To capture an authorized PayPal payment in Sprii, open Orders. Open the matching order by clicking its row away from the payment icon on the right. Do not use the row’s payment icon to open the order: when its tooltip says Click to capture followed by an amount, one click submits that capture immediately. In the order dialog, Capture followed by an amount appears when an amount is available to capture. Check the order and displayed amount before clicking: that button also submits the capture immediately. Check the matching transaction in PayPal for the result. Moving a Sprii order to Completed does not capture the payment.

Keep the Secret out of screenshots and support messages. A person with access to the order can start an eligible PayPal refund in Sprii; see Refund an order.

These settings belong to the selected Page. Existing campaigns use the current method and title when checkout loads, and new payments use the current credentials. Saving does not rewrite an issued payment link. Changing credentials or merchant account may prevent capture or refund of earlier payments.


Need help? Contact Sprii Support