PayPal NVP_Express Checkout

PayPal NVP_Express Checkout

PayPal Integration

Compatible with OrderLogix Version 4.0 & up, Winter 2019



Module: Payment Data
Topic: PayPal Integration
Version(s):  All
Editions: All

Change Log:

Date
By
Notes
2/18/2019
SPG
Added Custom Value for currency code





PayPal Express Checkout: Gateway Integration :

With this integration installed to your instance, you can perform Settlements, Sales, or Refunds on PayPal transactions. The ability to perform Authorizations is not present in this integration because this type of transaction must be completed by the customer within their PayPal account.  Also please note to do future transaction on Continuity or Installment orders you must be passed the BAID(Billing Agreement ID) when the order is Submitted. 





API Credentials :

Obtaining API Credentials on your PayPal Account

To use the PayPal Express Checkout API, you must have API credentials that identify you as a PayPal Business or Premier Account holder who is authorized to perform various API operations. Although you can use either an API signature or a certificate for credentials, PayPal recommends you use a signature.

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.