PayPal

PayPal is a globally recognized digital payment platform that enables secure online transactions between individuals and businesses worldwide. Operating as both a payment processor and digital wallet, PayPal allows users to link their bank accounts, credit cards, or stored balances to make purchases. The service provides buyer and seller protection policies, supports transactions in multiple currencies, and offers various integration options including standard checkouts, subscription billing, and in-app payments. With its extensive market presence across more than 200 countries and strong consumer trust, PayPal remains one of the most widely accepted alternative payment methods in e-commerce.

Payment method details

Currency	EUR
Countries	Global
Minimum transaction value	0.01
Maximum transaction value	Depends on the customers PayPal account.
Capture	Supported
Cancel	Supported
Refund	Full and (multiple) partial refunds are supported. Up to 180 days.
Disputes	Supported
Statement descriptor	Dependent on PayPal configuration.

warning

Please use the processing_account_id in case your merchant has a direct contract with PayPal, in which case multiple splits are not allowed, unless all splits go to the merchant that has the contract with PayPal.

Create a seamless flow with the Payments API

In The Payment API section we explain how the Payments API can be leveraged to create a payment flow.

Checkout integration

Let Rootline handle the payment method selection. You initiate the payment by simply sending a payment request with below details.

{
  "account_id": "acc_12347Sifdo36cdycbsw4Pum",
  "amount": {
    "currency": "EUR",
    "quantity": "20.00"
  },
  "reference": "test_reference",
  "statement_descriptor":"Bank statement text",
  "return_url":"https://www.my_return_url.com"
}

The API will return a next_action object with a checkout_url. This url leads your customer to the Rootline checkout page, where they can select their payment method and further payment details.

{
    "id": "pmt_UXRFkdU6kdAtO6ceGdxmW",
    "created_at": "2023-09-12T08:22:25.864452Z",
    "account_id": "acc_12347Sifdo36cdycbsw4Pum",
    "reference": "test_reference",
    "amount": {
        "currency": "EUR",
        "quantity": "20.00"
    },
    "checkout_status": "open",
    "authorizations": [],
    "authentications": [],
    "next_action": {
        "checkout_url": "http://checkout.staging.rootline.com/payments/pmt_UXRFkdU6kdAtO6ceGdxmW/checkout"
    },
    "statement_descriptor":"Bank statement text",  
    "return_url": "https://www.my_return_url.com"
}

Forwarding your customer through the checkout url

Request a redirect to your customer's bank by calling (/GET) the checkout_url that Rootline provides.

Seamless redirect from your website to PayPal

The seamless integration allows you to redirect a customer from your page directly to PayPal, without visibly interacting with Rootline's checkout pages. Payment method selection can be done in your own page. In addition to the /POST request above, to indicate that this is an PayPal payment, provide paypal as the value for the payment_rails.payment_method field:

{
  "account_id": "acc_12347Sifdo36cdycbsw4Pum",
  "amount": {
    "currency": "EUR",
    "quantity": "20.00"
  },
  "payment_rails":{
    "payment_method":"paypal"
  },
  "reference": "test_reference",
  "description":"Test description",
  "statement_descriptor":"Bank statement text",
  "return_url":"https://www.my_return_url.com"
}

Use the checkout redirect url for a seamless redirect to PayPal. After completion of the payment, your customer will be redirected back to the return url that you provided.

{
    "id": "pmt_UXRFkdU6kdAtO6ceGdxmW",
    "created_at": "2023-09-12T08:22:25.864452Z",
    "account_id": "acc_12347Sifdo36cdycbsw4Pum",
    "reference": "test_reference",
    "amount": {
        "currency": "EUR",
        "quantity": "20.00"
    },
    "payment_rails":{
        "payment_method":"paypal"
    },
    "checkout_status": "open",
    "authorizations": [],
    "authentications": [],
    "next_action": {
        "checkout_url": "http://checkout.staging.rootline.com/payments/pmt_UXRFkdU6kdAtO6ceGdxmW/redirect"
    },
    "statement_descriptor":"Bank statement text",
    "return_url": "https://www.my_return_url.com"
}