...
If your account requires FraudNet, please be sure to send the FraudNet data when calling import order and confirmPayPal under the paypalClientMetadataId fieldusing the paypalClientMetadataId field when calling Import Order.
PayPal can process direct credit cards if your account is setup properly. Card processing on a PayPal Commerce gateway requires no special handling. Process the card using a normal checkout flow or using 3DS flow. This document assumes you are processing using PayPal checkout and NOT direct credit cards.
...
Checkout Page
Step 1: Import Click
...
The Checkout page contains the PayPal button. Call the Import Click API when the page loads to obtain a session.
...
| Info |
|---|
If this is the first page of the funnel - Send requestUri (include affiliate tracking string for reporting) instead of sessionId. The response from this call will contain a sessionId which should be sent on all subsequent API calls for this session. |
Step 2: Import Order
...
It is important that you bind the Import Order call to the PayPal checkout button.
Be sure to include the sessionId and orderId from the previous steps, if knownCard details are optional. PayPal may accept credit cards if your account is setup properly. In most cases you will not pass card details.
There are four PayPal specific requirements that need to be passed to Import Order:
paySource needs to be set to = 'PAYPAL'
forceMerchantId is the value assigned to your PayPal Commerce gateway, found on your gateway list.
redirectsTo is the url of the page in your funnel that PayPal will redirect to on a successful transaction.
errorRedirectsTo is the url of the page in your funnel that PayPal will redirect to on a cancelled transaction.
...
A successful response will return a MERC_REDIRECT exception to the page along with a PayPal url.
...
| Code Block |
|---|
if (result === "MERC_REDIRECT") {
if (message && message.url) {
window.location.href = message.url;
}
} |
Upsell Pages
Step
...
3: Import Click
...
After a successful Confirm Paypal call, the customer proceeds to the next page in the funnel, 'upsellPage1', and another click is imported using the Import Click endpoint.
Be sure to include pageType=upsellPage1 and sessionId
Step
...
4: Import Upsale
...
One-click Upsells
PayPal supports one-click upsells using Reference Transactions. You must enable referenceTransactions on both the CheckoutChamp gateway and on the backend of PayPal. You must work with PayPal to get this enabled. In most cases Reference Transactions can be enabled for North American merchants and cannot be enabled for European merchants.
If the customer chooses to buy an upsell, submit this the product by using standard functionality on the Import Upsell Upsale endpoint.
...
Two-click Upsells
PayPal merchants without Reference Transactions must process upsells be sending the consumer through the entire PayPal checkout flow again. The redirect instructions in the Checkout section above must be followed on Upsell pages.
If the customer chooses to buy an upsell, submit the product using the Import Upsale endpoint.
There are four PayPal specific requirements that need to be passed to Import Upsale:
paySource = 'PAYPAL'
forceMerchantId is the value assigned to your PayPal Commerce gateway, found on your gateway list.
redirectsTo is the url of the page in your funnel that PayPal will redirect to on a successful upsell transaction.
errorRedirectsTo is the url of the page in your funnel that PayPal will redirect to on a cancelled upsell transaction.
| Info |
|---|
Repeat Step |
...
3 (increment upsellPage#) and Step |
...
4 for each upsell page in your funnel. |
Thank You Page
Step 9: Import Click
...
After all upsells the customer finally lands on the Thank You (receipt) page and another click is imported using the Import Click endpoint.
Be sure to include pageType=thankyouPage and sessionId
Step 10: Confirm Order
...
Confirm Order is called to send the customer a confirmation email immediately.
...