Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Note

This PayPal implementation should be used if you are capturing the consumer’s name prior to checkout. If however you allow a consumer to checkout before entering any identifiable information then use the legacy workflow.

Warning

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

Note

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

...

If your account requires FraudNet, please be sure to send the FraudNet data using in the paypalClientMetadataId field parameter when calling Import Order and Confirm PayPal API.

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.

...

  • Be sure to include the sessionId and orderId from the previous steps, if known

There are four five PayPal specific requirements that need to must be passed to Import Order:

  1. paySource = 'PAYPAL'

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

  3. salesUrl is = the checkout page url

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

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

...

Code Block
{
    "result": "MERC_REDIRECT",
    "message": {
        "paypalUrlurl": "https://www.paypal.com/agreements/approvecheckoutnow?ba_token=XXXXXXXXXXXXXXXXXX"
    }
}

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

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

Upsell Pages

Step 3: Import Click

...

PayPal supports one-click upsells using Reference Transactions. You must enable referenceTransactions on both the Konnektive CRM 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 International merchants.

If the customer chooses to buy an upsell, submit the product using standard functionality on the Import Upsale endpoint.

...

There are three PayPal specific requirements that need to must be passed to Import Upsale:

  1. paySource = 'PAYPAL'

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

  3. 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.

Info

Follow step 5 or 6. It is not necessary to do both.

Thank You Page

Step 5: Import Click

...