PayPal Integration

Compatible with OrderLogix Version 4.0 & up, Winter 2019

---

Module: Payment Data

Topic: PayPal Integration

Version(s):  All

Editions: All

Change Log:

PayPal Express Checkout: Gateway Integration :

API Credentials :

Obtaining API Credentials on your PayPal Account

Creating an API Signature

An API signature consists of an API username along with an associated API password and signature, all of which are assigned by PayPal. You need to include this information whenever you execute a PayPal API operation. 

You must have a PayPal Business account to create a signature. 

To create an API signature:

1. Log in to PayPal, then click  Profile  under  My Account .
   
2. Click  My selling tools .
   
3. Click “Update” for  API Access .
   
4. Click  Manage API Credentials .
   
5. Click Show next to each to display.
   
6. Click  done  to complete the process.

          To speak directly with PayPal Integration Specialists / Website Connection,

          Please call 1-855-684-1965 (option 2 or 3) Monday - Friday, 9am to 6pm CST

Submitting Orders:  

            The PayPal Billing Agreement ID returned from  PayPal Express Checkout  will be submitted to OrderLogix as a Token for continuity billing using either the OrderLogix API or Order Import v4. To accompany the Token,the following must also be sent:

- the method of payment, CC. 

- the credit card type.

- a placeholder credit card number (see list of card numbers that will pass a mod10 check  here , and instructions for setting the placeholder card numbers for tokenized accounts  here ).

- the credit card expiration date.

- the name of the Express Checkout Payment Processing Account, as set up in OrderLogix.

OrderLogix API

The PayPal Billing Agreement ID will be passed in the XML <TOKEN> element.

The name of the PayPal Express Checkout Payment Processing Account will be passed in the XML <PAY_PROC_ACCT> element.

The method of Payment (CC) will be passed in the XML <PAYMENT_METHOD> element.

The credit card type will be passed in the <CC_TYPE> element. 

The placeholder credit card number will be passed in the XML <CC_NUMBER> element. 

The card expiration date will be passed in the XML <EXP_DATE> element.

Example:

<PAYMENT_METHOD>CC</PAYMENT_METHOD>

<CC_TYPE>V</CC_TYPE>

<CC_NUMBER>4111111111111111</CC_NUMBER>

<EXP_DATE>05/25</EXP_DATE>

<TOKEN>36X58962RS656712N</TOKEN>

<PAY_PROC_ACCT>PayPal Express Checkout</PAY_PROC_ACCT>

API Documentation:

https://support.orderlogix.com/portal/en/kb/articles/orderlogix-real-time-order-submission-api  

OrderLogix Import v4.0

The PayPal Billing Agreement ID will be passed in the column 17 “TOKEN” field.

The name of the PayPal Express Checkout Payment Processing Account will be passed in column 18 “PAY_PROC_ACCT” field.

The method of Payment (CC) will be passed in column 52 "PAYMENT_METHOD" field.

The credit card type will be passed in the column 19 "CC_TYPE" field. 

The placeholder credit card number will be passed in the column 20 "CC_NUMBER" field. 

The card expiration date will be passed in the column 21 "EXP_DATE" field.

Import Documentation:

https://support.orderlogix.com/portal/en/kb/articles/olx-order-import-export-v4-spec  

When importing token orders, the CC_TYPE, CC_NUMBER, EXP_DATE fields still need to be filled in. The credit card type and expiration date should reflect the customer's actual card information. However, the credit card number field should be filled in with the DUMMY credit card number that is set up in the OrderLogix system preferences settings for the customer's given card type.

Custom Values :

We do accept a dynamic currency code by using a Campaign Custom Value. By default, the currency code is set to "USD", but if you add a campaign custom value with the name "CURRENCY_CODE", then this gateway will override the currency code with whatever you provide for a value in the campaign custom value.