Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

Authorization trials (such as Hold Trial Charge, Authorize and Void, etc.) are not supported through PayPal Seamless Checkout

You must use live PayPal credentials. Using sandbox credentials will result in an error reading “Security error: Security header is not valid”

Please click here for instructions on integrating PayPal with a form code lander

If your account requires FraudNet, please be sure to send the FraudNet data when calling import order and confirmPayPal under the paypalClientMetadataId field.

Checkout Page

Step 1: Import Click - https://api.konnektive.com/landers/clicks/import/?

The Checkout page contains the PayPal button. Call the Import Click API when the page loads to obtain a session.

  • Be sure to include pageType=checkoutPage and sessionId

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 - https://api.konnektive.com/order/import/?

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 known

  • Card 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:

  1. paySource needs to be set to 'PAYPAL'

  2. forceMerchantId is the value assigned to your PayPal Commerce gateway, found on your gateway list.

  3. redirectsTo is the url of the page in your funnel that PayPal will redirect to on a successful transaction.

  4. errorRedirectsTo is the url of the page in your funnel that PayPal will redirect to on a cancelled transaction.

SUCCESS

A successful response will return a MERC_REDIRECT exception to the page along with a PayPal url.

{
    "result": "MERC_REDIRECT",
    "message": {
        "url": "https://redirecttheuserhere.com"
    }
}

This example script can be used to redirect the consumer to PayPal

if (result === "MERC_REDIRECT") {
    if (message && message.url) {
        window.location.href = message.url;
    }
}

Upsell Pages

Step 7: Import Click - https://api.konnektive.com/landers/clicks/import/?

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 8: Import Upsale - https://api.konnektive.com/upsale/import/

All upsells are one-click. If the customer chooses to buy an upsell, submit this product by using the Import Upsell endpoint.

To use PayPal with upsells you will need to ensure that referenceTransactions is enabled on both the gateway inside the CRM and also on the backend of PayPal.

Repeat Step 7 (increment upsellPage#) and Step 8 for each upsell page in your funnel.

Thank You Page

Step 9: Import Click - https://api.konnektive.com/landers/clicks/import/?

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 - https://api.konnektive.com/order/confirm/

Confirm Order is called to send the customer a confirmation email immediately.

  • Be sure to include the orderId

  • No labels