PayPal - Smart Button

This page presents all information related to the PayPal connection using Smart Button as payment. Use the following buttons to navigate to the desired section.

General information

Countries:

globe-flag
Available in over 200 countries

Currencies:

AUD, BRL, CAD, CNY, CZK, DKK, EUR, HKD, HUF, ILS, JPY, MYR, MXN, TWD, NZD, NOK, PHP, PLN, GBP, RUB, SGD, SEK, CHF, THB, USD.

Minimum amount:

Debit 1 USD.

Maximum amount:

Debit 5000 USD

Payment methods:

Credit card
Credit card
debit card
Debit card
BNPL
BNPL

TRX without CVV:

No

Purchase TRX in 1-Step:

Yes

Purchase TRX in 2-Step:

Yes

Support for recurrency:

No

Webhooks:

Yes

Captures

Partial capture:

Yes

Multiple captures:

Yes, you can complete partial captures during a single authorization period. For PayPal payment authorizations, you must enable this feature on your PayPal account.

Maximum time to capture an authorization:

While an authorization places a hold on the funds and is valid for 29 days, we recommend that you capture the funds within the three-day honor period.

Captures over the amount of authorization:

Yes

Maximum amount:

You can reauthorize it for up to 115% of the originally authorized amount or an increase of $75 USD (whichever is the lesser amount).

Refunds

Refund support:

Yes

Partial refunds:

Yes

Multiple refunds:

No

Time to request refund:

180 days after transaction date.

Time to process refund:

5 business days.

Chargebacks

Notifications of chargebacks:

Yes

Defined period to make a chargeback:

180 days or more after an order’s been placed.

Endpoint for disputes:

Yes

Maximum time to dispute a chargeback (provide evidence):

10 days.

Testing guidelines for sandbox environment

Necessary fields for testing:

Client ID, Secret.

Test cards:

For testing cards in PayPal Sandbox use the Credit Card Generator for Testing.

Limitations/ Specifications for testing:

  • To simulate a successful credit card capture, you can test using a test card number.
  • To simulate credit card failures, pass a rejection trigger in the First Name or Name on Card field in your existing advanced credit and debit card payment integration. You must use a Visa test card number. All failure test simulations show that the card is globally unavailable (AVS) and not processed (CVV), but the response-code value changes based on the test trigger you use. See For testing cards in PayPal Sandbox use the rejection triggers.
To ensure you handle errors correctly, use negative testing to force flows through specific error conditions. The sandbox is a positive test environment by default, to use negative testing, you must enable it.

Integration configuration

Credentials and steps to obtain them:

  1. Log in to the PayPal Developer Portal using the same credentials you use for PayPal.
  2. Select Dashboard.
  3. Click Create App under REST API apps. Any previously created REST API apps will appear in the table under the Create App button.
  4. Enter the name of your REST API app in the App Name field, and select a Sandbox developer account to associate with your account.
  5. Once your Live and Sandbox REST API credentials are created, including Client ID and Secret, click the Sandbox and Live buttons to switch between each set of credentials.

Dashboard configuration:

  1. Log in to dashboard.y.uno.
  2. Click Connections and then select PayPal.
  3. Click Connect.
  4. Select Cash in Payment Methods.
  5. Introduce Name, Secret ID and Client ID.
  6. Click Connect.

Configuration of webhooks in partner:

  1. Log in to the PayPal Developer Portal using the same credentials you use for PayPal.
  2. Select Dashboard.
  3. Select the application of your choice.
  4. In the bottom of the page, you can view the Webhooks section. Click in “Add Webhook”.
  5. Enter the webhook url.
  6. Specify the events.
  7. Save

Production environment

Specific procedure for a merchant to go live:

-

Conciliation configuration:

SFTP