Integration Guide

Express Checkout ~ Integration Overview
8/16/2013 Page 14 of 18
 Regardless of the specified currency, the format for most currencies must
include a decimal point with exactly two digits to the right and an optional
thousands separator to the left, which must be a comma.
 For example, EUR 2.000,00 must be specified as 2000.00 or 2,000.00.
 The specified amount cannot exceed USD $10,000.00, regardless of the
currency used.
NOTE: Some currencies such as Yen do not support decimal points. See the
PayPal Currency Codes page for currencies that do not support decimals.
PAYMENTREQUEST_0_AMT=amount
PAYMENTREQUEST_0_CURRENCYCODE=currencyID
Specify the payment action.
 Although the default payment action is a Sale, it is a best practice to
explicitly specify the payment action as one of the following values:
PAYMENTREQUEST_0_PAYMENTACTION=Sale
PAYMENTREQUEST_0_PAYMENTACTION=Authorization
PAYMENTREQUEST_0_PAYMENTACTION=Order
 Execute the DoExpressCheckoutPayment API to complete the Express
Checkout transaction.
 Examine the values returned by the API if the transaction completed
successfully (ACK=Success).
Use case 2: Auth / Capture
An Authorization is used to put a hold on the funds. When you submit an Authorization you
are asking PayPal to see if the funds are available, and if they are, to place a hold on them
for 3 days.
You can capture an Authorization for up to 29 days; however, the funds are only on hold for
3 days. These 3 days are known as the "honor period".
NOTE: The honor period is a PayPal function. This is 3 days by default, and the
maximum honor period is 10 days. This time period is dependent on the card-issuing
bank or the bank itself in ACH transactions such as a bank initiated transfer.
Authorization Example:
You know that you have the product in stock, but you only ship on Wednesdays and
Fridays; and, today is Monday.
Monday: