PayPal

Introduction

Paypal is a payment service that allows you to make payments using the Paylands' checkout page or simply a redirection.

Restrictions and requirements

Only EUR currency is supported currently.

When generating the payment order at least the profile and billing_address fields must be provided in order to be able to reconcile payments via PayPal.

"extra_data": {
    "checkout": {
        "uuid": "C42043F9-B77C-4918-BD43-86C526B4F24D"
    },
    "profile": {
        "first_name": "John",
        "last_name": "Doe",
        "email": "johndoe@gmail.com",
        "phone": {
            "number": "666666666",
            "prefix": "34"
        }
    },
    "billing_address": {
        "city": "Castellon",
        "country": "ESP",
        "address1": "Avinguda del Mar 23",
        "zip_code": "12000",
        "state_code": "CT"
    }
}

STC (Set Transaction Context)

STC data allows enriching the transaction information with additional details about the buyer and the contracted service.

In the request used to generate the payment order:

Buyer data is sent in extra_data.profile and extra_data.billing_address
OTA (Online Travel Agency) context data, related to the booking or travel service, is sent in extra_data.payment

OTA data is only required for specific industries, such as hotels.

OTA - Hotels (MCC 7011)

The following fields correspond to the OTA context for the hotel use case.

All OTA fields must be sent within extra_data.payment.

Field	Type	Description	Example
`buyer_creation_date`	`string (ISO 8601 datetime)`	Date when the user was registered in the merchant's system	`2012-12-09T19:14:55.277+00:00`
`ota_type`	`string`	Industry type within the OTA context. For hotels, it must be `"hotel"`	`"hotel"`
`ota_service_start_date`	`string (ISO 8601 datetime)`	Start date of the stay (check-in)	`2026-06-01T15:00:00+00:00`
`ota_service_end_date`	`string (ISO 8601 datetime)`	End date of the stay (check-out)	`2026-06-05T12:00:00+00:00`
`ota_change_guest`	`boolean`	Indicates whether the booking can be transferred to another guest	`false`
`ota_start_country`	`string (ISO Alpha-2)`	Country code where the stay begins	`"ES"`
`ota_start_city`	`string`	City where the stay begins	`"Madrid"`
`ota_start_zipcode`	`string`	Postal code where the stay begins	`"28080"`

Example

{
    "extra_data": {
        "profile": {
            "first_name": "John",
            "last_name": "Doe",
            "email": "john@doe.com",
            "birthdate": "1984-11-28",
            "phone": {
                "number": "678767878",
                "prefix": "+34"
            }
        },
        "billing_address": {
            "city": "Madrid",
            "country": "ESP",
            "address1": "Avenida principal, 24",
            "zip_code": "12345",
            "state_code": "ESP"
        },
        "payment": {
            "buyer_creation_date": "2012-12-09T19:14:55.277+00:00",
            "ota_type": "hotel",
            "ota_service_start_date": "2012-12-09T19:14:55.277+00:00",
            "ota_service_end_date": "2012-12-14T19:14:55.277+00:00",
            "ota_change_guest": false,
            "ota_start_country": "ES",
            "ota_start_city": "Madrid",
            "ota_start_zipcode": "28080"
        }
    }
}

Sandbox

Use the following credentials to complete a payment in sandbox environment using both PayLater and Paypal payment methods:

username: sb-uto4v27115289@personal.example.com
password: 3T9gvRX>

Make a payment with PayPal:

username: sb-y94a925372648@business.example.com
password: U@2!S[gZ

Amount restrictions for PayLater

PayLater is supported in several countries, each one having different requisites regarding the amount and payment terms.

Spain, Italy and UK: amount between 30 and 2000 euros (EUR), payment in 3 installments.
Germany: amount between 99 and 5000 euros (EUR), payment can be split among 3, 6, 12, and 24 installments. In addition you can choose to pay 30 days after purchase if the amount ranges between 1 and 1000 euros (EUR).
France and Australia: amount between 30 and 2000 euros (EUR), payment in 4 installments.
United Kingdom: if the amount is greater than 99 euros (EUR), 0% interest may be applied to your purchase.
United States: amount between 30 and 1500 euros (EUR), payment in 4 installments but with a collection day every two weeks. There is an option to pay every month, but the installments must be 6, 12 or 24 and the amount must range between 199 and 10000 euros (EUR).

Introduction​

Restrictions and requirements​

STC (Set Transaction Context)​

OTA - Hotels (MCC 7011)​

Example​

Sandbox​