PayPal
You can start by placing a ‘PayPal’ button next to other payment methods you process in your web shop. With clicking on this button, you construct a Sale (or PreAuth) transaction request to our Gateway. This will take your customers to our hosted payment page, where PayPal JS Smart Buttons are rendered. After being redirected to the wallet login page, the cardholders can proceed with payment completion.
Alternatively, you can let your customer select the payment method on the Gateway’s hosted payment method selection page. If you prefer this option, please do not submit a value for the payment method parameter in your payment request.
You can optionally include the following details when calling the /checkouts endpoint:
| Field name | Type | Description |
|---|---|---|
checkoutSettings.preSelectedPaymentMethod | C | If you want to pre-select PayPal, then use value 'PayPal'. |
order.shipping.person | O | Name and date of birth of the payer |
`order.shipping.contact | O | Contact details of the payer |
`order.shipping.address | O | Address of the payer |
order.basket.lineItems | O | As part of a line item, you can also submit your VAT and shipping cost (as a delivery/shipping fee). |
order.orderDetails.invoiceNumber | O | Represents PayPal invoice ID, the field must be populated if available during request submission. This value will be visible in your PayPal seller account while reviewing a transaction. |
If you fall under the category of high-risk merchants on PayPal side, you will also need to send the following parameters:
| Field name | Type | Description |
|---|---|---|
payPal.riskData.clientMetaId | C | The purpose of this parameter is to pass the session information to PayPal to correlate your payment request with the corresponding call submitted to the PayPal Risk Services. |
In addition to mandatory fields, you can also send PayPal specific data by using the key-value pairs under payPal.riskData.merchantParameters
| Field name | Type | Description |
|---|---|---|
shippingPreference | O | Possible values: - SET_PROVIDED_ADDRESS Customer can see the address details inside the wallet but cannot change it. The address details are provided as part of the Gateway response. - NO_SHIPPING Customer cannot see the address details inside the wallet nor can change it. No address details are provided as part of the Gateway response. |
stc-content | C | This parameter will provide content for the PayPal Set Transaction Context (STC) with sufficient data for the PayPal Risk Services analysis before the transaction is authorized. In addition to 'stc-content' consider also a need to submit a specific risk tracking id ( payPal.riskData.clientMetaId) in your request. |
Updated about 16 hours ago
