Search Developer Site

PayPal Express Checkout

PayPal Express Checkout for Authorize.Net enables you to offer PayPal as a payment option to your customers by incorporating it within your existing XML API implementation.

PayPal Express Checkout is not supported by some resellers and is not offered in some countries. For more information, contact your reseller. PayPal Express Checkout does not support the full PayPal feature-set, including $0 authorizations. PayPal transactions are not subject to AFDS fraud filters, except the IP blacklist filter.

To use PayPal Checkout Express:

  • A Business or Premier PayPal account. A Business or Premier account enables you to become a merchant for whom PayPal collects money from buyers for goods or services. PayPal manages these transactions and charges you a small fee and a percentage of the amount collected from the buyer for each transaction.

  • A PayPal sandbox account with two test accounts. The PayPal sandbox provides an environment that simulates PayPal in which you execute your Express Checkout integration without actually exchanging money. One of your test accounts represents you as the merchant; the other test account represents a buyer. Your testing is not restricted to just two accounts; however, you must have a sandbox account to create test accounts and perform actual testing. The PayPal sandbox URL is:

https://developer.paypal.com/docs/classic/lifecycle/ug_sandbox/

Note: Refunds cannot be tested in the sandbox environment because the settlement process is not being enabled.

Button Placement

Customers choose PayPal because they are familiar with the checkout experience and trust the security that PayPal offers. Placing the PayPal button early in the checkout flow will ensure increased sales lift, because customers will know early on that PayPal is a payment option. Note that the customer only initiates PayPal Express Checkout when they choose PayPal as a payment option. When they choose to "check out with PayPal," they are routed directly to PayPal.

For more information on Express Checkout Best practices, click here.

Transaction Types

The transaction flow for PayPal Express Checkout for Authorize.Net is different than a credit card transaction flow. The initial request to authorize a transaction notifies PayPal that an authorization has been initiated. Information that can be used to continue the authorization must be returned from PayPal.

PayPal Express Checkout for Authorize.Net uses the following transaction types.

Authorization Only

An Authorization Only request notifies PayPal that an authorization has been initiated but does not complete the authorization. It returns a secure URL with a token appended to it. The purpose of this token is to identify the transaction when the customer is redirected to PayPal.

Get Details

A Get Details transaction returns customer's PayPal Payer ID, email address, and shipping information. Get Details can be called at any time and is most useful after the customer has approved the payment at PayPal.

Authorization Only, Continued

This request, if successful, actually authorizes the transaction but does not capture it.

Prior Authorization Capture

This transaction type is used to capture an Authorization Only, Continue transaction that was successfully authorized through the payment gateway.

Void

This transaction type can be used to cancel an authorization that has not yet been captured. Void can be used only in the following sequence: Authorization Only, Authorization Only Continue, Void.

Authorization and Capture

This type of transaction is the most common and is the default payment gateway transaction type. Like the Authorization Only request, it notifies PayPal that an Authorization and Capture transaction has been initiated, but does not complete the request. It also returns a secure URL with a token appended to it. The purpose of this token is to identify the transaction when the customer is redirected to PayPal.

Authorization and Capture, Continued

This request actually authorizes and captures the transaction.

Refund

This transaction type is used to refund a customer for a transaction that was originally processed and successfully settled through the payment gateway. Refunds do not occur until after your transactions have been settled on our system, which happens after the cutoff time.

Transaction Flow

The transaction flow consists of three typical sequences:

Sequence 1

  1. Authorization Only
  2. Get Details (recommended for shipping)
  3. Authorization Only, Continue
  4. Prior Authorization Capture
  5. Refund (optional)
 

Sequence 2

  1. Authorization Only
  2. Get Details (recommended for shipping)
  3. Authorization Only, Continue
  4. Void
 

Sequence 3

  1. Authorization and Capture
  2. Get Details (recommended for shipping)
  3. Authorization and Capture, Continue
  4. Refund (optional)