Location: PHPKode > scripts > Paypal Class > paypal-class/PaypalVariables.html
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Paypal Variables</title>
<style type="text/css">
table,tr,td { border:1px solid blue;}
</style>
</head>

<body>
<p><a href="http://www.paypal.com/IntegrationCenter/ic_std-variable-reference.html" target="_self">ORGINAL PAGE</a> (Always use Original page for updated variables, this page is actual as of October 24, 2008 12PM EST). </p>
<h2>Technical HTML Variables</h2>
<div class="description">
  <p>Technical HTML variables control how PayPal responds technically when buyers click Buy Now, Donation, Add to Cart, View Cart, Subscription, and Gift Certificate buttons or when third party shopping carts or custom carts initiate payment processing.</p>
  <h5>Allowed Values for cmd HTML Variable</h5>
  <br>
  <!-- Begin Allowed Values for cmd Variable -->
  <table class="example-definition" width="100%">
    <thead>
      <tr>
        <td style="width: 25%;">Value of cmd</td>
        <td style="width: 75%;">Description</td>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="label">_xclick</td>
        <td>The button that the person clicked was a Buy Now button.</td>
      </tr>
      <tr>
        <td class="label">_cart</td>
        <td>The button that the person clicked was an Add to Cart button or a View Cart button for the PayPal Shopping Cart, or the command was sent by a third party shopping cart or custom cart uploading the cart contents to PayPal.</td>
      </tr>
      <tr>
        <td class="label">_oe-gift-certificate</td>
        <td>The button that the person clicked was a Buy Gift Certificate button.</td>
      </tr>
      <tr>
        <td class="label">_xclick-subscriptions</td>
        <td>The button that the person clicked was a Subscribe button.</td>
      </tr>
      <tr>
        <td class="label">_donations</td>
        <td>The button that the person clicked was a Donate button.</td>
      </tr>
      <tr>
        <td class="label">_s-xclick</td>
        <td>The button that the person clicked was protected from tampering by using encryption.<br>
          For more information, see <a href="http://www.paypal.com/IntegrationCenter/ic_button-encryption.html">Encrypted Website Payments</a>.</td>
      </tr>
    </tbody>
  </table>
  <!-- End Allowed Values for cmd Variable -->
  <br>
  <br>
  <h5>HTML Variables: IPN notify_url</h5>
  <br>
  <!-- Begin HTML Variables: IPN notify_url -->
  <table class="example-definition" width="100%">
    <thead>
      <tr>
        <td style="width: 20%;">Name</td>
        <td style="width: 55%;">Description</td>
        <td style="width: 20%;">Required or Optional</td>
        <td style="width: 5%;">Character Length</td>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="label">notify_url</td>
        <td>The URL to which PayPal posts information about the transaction via <a href="http://www.paypal.com/IntegrationCenter/ic_ipn.html">Instant Payment Notification</a>. Must be URL-encoded.</td>
        <td>Optional</td>
        <td>255</td>
      </tr>
    </tbody>
  </table>
  <!-- End HTML Variables: IPN notify_url -->
</div>
<a name="HTMLVariablesforIndividualItems"></a>
<h2>HTML Variables for Individual Items</h2>
<div class="description">
  <p>HTML variables for individual items specify information about a product or service for Buy Now and Add to Cart buttons, or they specify information about a contribution for Donation buttons.</p>
  <h5>HTML Variables: Item Information</h5>
  <br>
  <!-- Begin HTML Variables: Item Information -->
  <table class="example-definition" width="100%">
    <thead>
      <tr>
        <td style="width: 20%;">Name</td>
        <td style="width: 55%;">Description</td>
        <td style="width: 20%;">Required or Optional</td>
        <td style="width: 5%;">Character Length</td>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="label" valign="top">amount</td>
        <td>The price or amount of the purchase, not including shipping, handling, or tax. If omitted in Buy Now or Donations, customers can enter an amount at time of purchase.<br>
           •  Optional for Buy Now or Donations<br>
           •  Required for Shopping Cart</td>
        <td>See description.</td>
        <td></td>
      </tr>
      <tr>
        <td class="label">item_name</td>
        <td>Description of item. If omitted in Buy Now or Donations, customers can enter an item name at time of purchase.<br>
           •  Optional for Buy Now or Donations<br>
           •  Required for Shopping Cart</td>
        <td>See description.</td>
        <td>127</td>
      </tr>
      <tr>
        <td class="label">item_number</td>
        <td>Passthrough variable for you to track purchases or donations, passed back to you at payment completion.</td>
        <td>Optional</td>
        <td>127</td>
      </tr>
      <tr>
        <td class="label" valign="top">quantity</td>
        <td>Number of items. If profile-based shipping rates are configured with a basis of quantity, the sum of quantity values is used to calculate the shipping charges for the transaction.<br>
          PayPal appends a sequence number to uniquely identify the item in the PayPal Shopping Cart (e.g., quantity1, quantity2). <br>
          <br>
          <span class="emphasis note">Note:</span> The value for quantity must be a positive integer. Null, zero, or negative numbers are not allowed.</td>
        <td>Optional</td>
        <td></td>
      </tr>
      <tr>
        <td class="label">undefined_<br>
          quantity</td>
        <td>1: allows buyer to specify the quantity. <br>
            <br>
            <span class="emphasis note">Note:</span> This variable is allowed only in Buy Now or Donations, and not allowed in shopping carts.</td>
        <td>Optional</td>
        <td>1</td>
      </tr>
      <tr>
        <td class="label">weight</td>
        <td>Weight of items. If profile-based shipping rates are configured with a basis of weight, the sum of weight values is used to calculate the shipping charges for the transaction.</td>
        <td>Optional</td>
        <td> </td>
      </tr>
      <tr>
        <td class="label">weight_unit</td>
        <td>The unit of measure if weight is specified. Possible values are:<br>
           •  lbs<br>
           •  kgs<br>
          Defaults to lbs.</td>
        <td>Optional</td>
        <td> </td>
      </tr>
      <tr>
        <td class="label">on0</td>
        <td>First option field name. If omitted, no variable is passed back to you. The os0 variable contains the corresponding value for the label specified in this variable. For example, if on0 is "size" then os0 could be "large".</td>
        <td>Optional</td>
        <td>64</td>
      </tr>
      <tr>
        <td class="label">on1</td>
        <td>Second option field name. If omitted, no variable is passed back to you. The os1 variable contains the corresponding value for the label specified in this variable. For example, if on1 is "color" then os1 could be "blue".</td>
        <td>Optional</td>
        <td>64</td>
      </tr>
      <tr>
        <td class="label">os0</td>
        <td>Option selected by the buyer from the first set of option values. If this option is selected through a text box or radio button, each value should be no more than 64 characters. If this value is entered by the customer in a text field, there is a 200 character limit. If omitted, no variable is passed back to you. <br>
          <br>
          <span class="emphasis note">Note:</span> on0 must also be defined. For example, it could be "size".</td>
        <td>Optional</td>
        <td>64 or 200<br>
            <br>
          See description. </td>
      </tr>
      <tr>
        <td class="label">os1</td>
        <td>Option selected by the buyer from the second set of option values. If this option is selected through a text box or radio button, each value should be no more than 64 characters. If this value is entered by the customer in a text field, there is a 200-character limit. If omitted, no variable is passed back to you. <br>
          <br>
          <span class="emphasis note">Note:</span> on1 must also be defined. For example, it could be "color".<br></td>
        <td>Optional</td>
        <td>64 or 200<br>
            <br>
          See description.</td>
      </tr>
    </tbody>
  </table>
  <!-- End HTML Variables: Item Information-->
</div>
<a name="HTMLVariablesforPaymentTransactions"></a>
<h2>HTML Variables for Payment Transactions</h2>
<div class="description">
  <p>HTML variables for payment transactions provide information about entire transactions, regardless of the individual items involved with the payment. You can use these variables with Buy Now, Donation, and View Cart buttons.</p>
  <h5>HTML Variables for Payment Transactions</h5>
  <br>
  <!-- HTML Variables: Transaction Information -->
  <table class="example-definition" width="100%">
    <thead>
      <tr>
        <td style="width: 20%;">Name</td>
        <td style="width: 55%;">Description</td>
        <td style="width: 20%;">Required or Optional</td>
        <td style="width: 5%;">Character Length</td>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="label" valign="top">address_<br>
          override</td>
        <td>1: The address specified in prepopulation variables overrides the user's stored address. The customer is shown the passed-in address but cannot edit it. If the address is not valid such as missing any required fields, including country) or not included, no address is shown.</td>
        <td>Optional</td>
        <td>1</td>
      </tr>
      <tr>
        <td class="label" valign="top">currency_<br>
          code</td>
        <td>The currency of the payment. Defines the currency in which the monetary variables (amount, shipping, shipping2, handling, tax) are denominated.<br>
          Default: all monetary fields are denominated as USD.</td>
        <td>Optional</td>
        <td></td>
      </tr>
      <tr>
        <td class="label" valign="top">custom</td>
        <td>Passthrough variable never presented to your customer.</td>
        <td>Optional</td>
        <td>256</td>
      </tr>
      <tr>
        <td class="label" valign="top">handling</td>
        <td>Handling charges. This is not quantity-specific. The same handling cost is charged regardless of the number of items on the order.<br>
          Default: no handling charges are included. </td>
        <td>Optional</td>
        <td></td>
      </tr>
      <tr>
        <td class="label" valign="top">invoice</td>
        <td>Passthrough variable you can use to identify your invoice number for this purchase. </td>
        <td>Optional</td>
        <td>127</td>
      </tr>
      <tr>
        <td class="label" valign="top">shipping</td>
        <td>The cost of shipping this item, if you enabled the override of automatic shipping calculations per transaction through your Account Profile. If shipping is used and shipping2 is not defined, this flat amount is charged regardless of the quantity of items purchased. <br>
          <br>
          <span class="emphasis note">Note:</span> If you use this variable, you do not need to set up shipping rates in your Account Profile. However, shipping rates you set up in your Profile take priority over values specified with this variable, unless you select the <strong>Override shipping methods per transaction</strong> checkboxes in the shipping methods you defined; the checkboxes are deselected by default. For more information, see <a target="_blank" href="https://www.paypal.com/en_US/ebook/PP_WebsitePaymentsStandard_IntegrationGuide/ProfileAndTools.html#1270716" class="popup-window">Overriding Shipping Calculations on Individual Transactions</a>.<br>
          <br>
          Default: if profile-based shipping is enabled, buyers are charged an amount according to the shipping methods they choose.</td>
        <td>Optional</td>
        <td> </td>
      </tr>
      <tr>
        <td class="label" valign="top">shipping2</td>
        <td>The cost of shipping each additional item. If omitted, and Profile-based shipping is enabled, buyers are charged an amount according to the shipping methods they choose.</td>
        <td>Optional</td>
        <td> </td>
      </tr>
      <tr>
        <td class="label" valign="top">tax</td>
        <td>Transaction-based tax override variable. Set this to a flat tax amount to apply to the transaction regardless of the buyer's location. This value overrides any tax settings set in your Profile. Default: Profile tax settings (if any) apply.</td>
        <td>Optional</td>
        <td> </td>
      </tr>
      <tr>
        <td class="label" valign="top">tax_cart</td>
        <td>Cart-wide tax, overriding any individual item tax_<i>x</i> value</td>
        <td>Optional</td>
        <td> </td>
      </tr>
      <tr>
        <td class="label" valign="top">weight_cart</td>
        <td>If profile-based shipping rates are configured with a basis of weight, this value is used to calculate the shipping charges for the transaction. This value overrides the weight values of individual items.</td>
        <td>Optional</td>
        <td> </td>
      </tr>
      <tr>
        <td class="label">weight_unit</td>
        <td>The unit of measure if weight_cart is specified. Possible values are:<br>
           •  lbs<br>
           •  kgs<br>
          Defaults to lbs.</td>
        <td>Optional</td>
        <td> </td>
      </tr>
    </tbody>
  </table>
  <!-- HTML Variables: Transaction Information -->
</div>
<br>
<a name="HTMLVariablesforShoppingCarts"></a>
<h2>HTML Variables for Shopping Carts</h2>
<div class="description">
  <p>HTML variables for shopping carts can be used with Add to Cart and View Cart buttons, as well as with third party shopping carts or custom carts that initiate payment processing.</p>
  <h5>HTML Variables for Shopping Carts</h5>
  <br>
  <!-- Begin HTML Variables Specific to Shopping Carts -->
  <table class="example-definition" width="100%">
    <thead>
      <tr>
        <td style="width: 20%;">Name</td>
        <td style="width: 10px;">Required or Optional</td>
        <td style="width: 45%;">Description</td>
        <td style="width: 25%;">Allowable Values</td>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="label" valign="top">add</td>
        <td>See description</td>
        <td>Add an item to the PayPal-hosted shopping cart. <br>
          This variable must be set as follows:<br>
          add=1<br>
          The alternative is the display=1 variable, which allows the user to view the contents of the PayPal Shopping Cart.<br>
          If both add and display are specified, display takes precedence.</td>
        <td>1</td>
      </tr>
      <tr>
        <td class="label" valign="top">amount</td>
        <td>Required</td>
        <td>Price of the item or the total price of all items in the shopping cart.</td>
        <td>Any valid currency amount</td>
      </tr>
      <tr>
        <td class="label" valign="top">business</td>
        <td>Required</td>
        <td>Email address for your PayPal account.</td>
        <td>Your email address</td>
      </tr>
      <tr>
        <td class="label" valign="top">display</td>
        <td>See description</td>
        <td>Display the contents of the PayPal Shopping Cart to the buyer. This variable must be set as follows:<br>
          display=1<br>
          The alternative is the add=1 variable, which adds an item to the PayPal Shopping Cart.<br>
          If both add and display are specified, display takes precedence.</td>
        <td>1</td>
      </tr>
      <tr>
        <td class="label" valign="top">handling_<br>
          cart</td>
        <td>Optional</td>
        <td>Single handling fee to be charged cart-wide. If handling_cart is used in multiple <strong>Add to Cart</strong> buttons, the handling_cart value of the first item is used.</td>
        <td>Any valid currency amount</td>
      </tr>
      <tr>
        <td class="label" valign="top">item_name</td>
        <td>Required</td>
        <td>Name of the item or a name for the entire Shopping Cart</td>
        <td></td>
      </tr>
      <tr>
        <td class="label" valign="top">paymentaction</td>
        <td valign="top">Optional</td>
        <td valign="top">Indicates whether transaction is payment on a final sale or an authorization for a final sale, with payments to be captured later. The default value is "sale". Set the value to "authorization" to authorize capture of a single payment. Set the value to "order" to authorize capture of multiple, partial payments.<br>
          <br>
          For more information, see the <a target="_blank" href="https://www.paypal.com/en_US/ebook/PP_WebsitePaymentsPro_IntegrationGuide/index.html" class="popup-window"><i>Website Payments Pro Integration Guide</i></a>. <br>
          <br>
          <span class="note">Important:</span> If you set "paymentaction" to "order", you must use the Authorization &amp; Capture API to capture the transaction payments. The merchant tools on the PayPal website let you capture payments only for authorizations, not for orders. </td>
        <td>sale<br>
          authorization<br>
          order</td>
      </tr>
      <tr>
        <td class="label" valign="top">upload</td>
        <td>See description</td>
        <td>Upload the contents of a third party shopping cart or a custom shopping cart. This variable must be set as follows:<br>
          upload=1<br>
          The alternatives are the add=1 variable and the display=1 variable, which are used with the PayPal Shopping Cart. </td>
        <td>1</td>
      </tr>
    </tbody>
  </table>
  <!-- End HTML Variables Specific to Shopping Carts -->
  <br>
  <br>
  <h5>HTML Variables for Individual Items in Third Party Shopping Carts</h5>
  <br>
  <!-- Begin HTML Variables: Individual Items in Third-Party Shopping Carts -->
  <table class="example-definition" width="100%">
    <thead>
      <tr>
        <td style="width: 20%;">Name</td>
        <td style="width: 10px;">Required or Optional</td>
        <td style="width: 55%;">Description</td>
        <td style="width: 15%;">Character Length</td>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="label" valign="top">amount_<i>x</i></td>
        <td>Required</td>
        <td>Price of item #<i>x</i>. This is only required if you specify upload=1.</td>
        <td></td>
      </tr>
      <tr>
        <td class="label" valign="top">handling_<i>x</i></td>
        <td>Optional</td>
        <td>The cost of handling for item #<i>x</i></td>
        <td></td>
      </tr>
      <tr>
        <td class="label" valign="top">item_name_<i>x</i></td>
        <td>Required</td>
        <td>Name of item #<i>x</i> in the cart. Must be alphanumeric</td>
        <td>127</td>
      </tr>
      <tr>
        <td class="label" valign="top">item_number_<i>x</i></td>
        <td>Optional</td>
        <td>Variable for you to track order or other purchase.<br>
          Default: no variable is passed back to you. </td>
        <td>127</td>
      </tr>
      <tr>
        <td class="label" valign="top">on0_<i>x</i></td>
        <td valign="top">Optional</td>
        <td valign="top">First optional field name for item #<i>x</i></td>
        <td>64</td>
      </tr>
      <tr>
        <td class="label" valign="top">on1_<i>x</i></td>
        <td>Optional</td>
        <td>Second optional field name for item #<i>x</i></td>
        <td>64</td>
      </tr>
      <tr>
        <td class="label" valign="top">os0_<i>x</i></td>
        <td>Optional</td>
        <td>First set of optional value(s) for item #<i>x</i>. Requires that on0_<i>x</i> also be set.</td>
        <td>200</td>
      </tr>
      <tr>
        <td class="label" valign="top">os1_<i>x</i></td>
        <td>Optional</td>
        <td>Second set of optional value(s) for item #<i>x</i>. Requires that on1_<i>x</i> also be set.</td>
        <td>200</td>
      </tr>
      <tr>
        <td class="label" valign="top">quantity_<i>x</i></td>
        <td>Optional</td>
        <td>Quantity of the item #<i>x</i>. The value of quantity_<i>x</i> must be a positive integer. Null, zero, or negative numbers are not allowed.</td>
        <td></td>
      </tr>
      <tr>
        <td class="label" valign="top">shipping_<i>x</i></td>
        <td>Optional</td>
        <td>The cost of shipping item <i>#x</i>. This variable excludes the item from automatic shipping calculations; the amount is added to the shipping charges calculated automatically on other items in the cart.</td>
        <td></td>
      </tr>
      <tr>
        <td class="label" valign="top">tax_<i>x</i></td>
        <td>Optional</td>
        <td>The tax amount for item #<i>x</i>.</td>
        <td></td>
      </tr>
      <tr>
        <td class="label" valign="top">weight_<i>x</i></td>
        <td>Optional</td>
        <td>The weight of item <i>#x</i>.</td>
        <td> </td>
      </tr>
      <tr>
        <td class="label">weight_unit</td>
        <td>Optional</td>
        <td>The unit of measure if weight_<i>x</i> is specified. Possible values are:<br>
           •  lbs<br>
           •  kgs<br>
          Defaults to lbs.</td>
        <td> </td>
      </tr>
    </tbody>
  </table>
  <!-- End HTML Variables: Individual Items in Third-Party Shopping Carts -->
</div>
<br>
<a name="HMTLVariablesforSubscriptions"></a>
<h2>HTML Variables for Subscriptions</h2>
<div class="description">
  <p>HTML variables for subscriptions specify information for Subscription buttons, such as trial periods, regular subscription periods and subscription renewals.</p>
  <h5>HTML Variables for Subscriptions</h5>
  <br>
  <!-- Begin HTML Variables for PayPal Subscriptions -->
  <table class="example-definition" width="100%">
    <thead>
      <tr>
        <td style="width: 15%;">Variable Name</td>
        <td style="width: 30px;">Required or Optional</td>
        <td style="width: 60%;">Description</td>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="label" valign="top">cmd</td>
        <td>Required</td>
        <td>Must be set to "_xclick-subscriptions"</td>
      </tr>
      <tr>
        <td class="label" valign="top">business</td>
        <td>Required</td>
        <td>This is your PayPal ID, or email address. This email address must be confirmed and linked to your Verified Business or Premier account.</td>
      </tr>
      <tr>
        <td class="label" valign="top">item_name</td>
        <td>Optional</td>
        <td>Description of item being sold (maximum 127 characters). If omitted, customer will see a field in which they have the option of entering an Item Name.</td>
      </tr>
      <tr>
        <td class="label" valign="top">return</td>
        <td>Optional</td>
        <td>An internet URL where the user will be returned after completing the payment. For example, a URL on your site that hosts a "Information on your new subscription" page. If omitted, users will be taken to the PayPal site.</td>
      </tr>
      <tr>
        <td class="label" valign="top">rm</td>
        <td>Optional</td>
        <td>Return URL behavior. If set to "1" and if a "return" value is submitted, upon completion of the payment the buyer will be sent back to the return URL using a GET method, and no transaction variables will be submitted. If set to "2" and if a "return" value is submitted, the buyer will be sent back to the return URL using a POST method, to which all available transaction variables will also be posted. If omitted or set to "0", GET methods will be used for all Subscriptions transactions and Buy Now, Donations, or PayPal Shopping Cart transactions in which IPN is not enabled. POST methods with variables will be used for the rest.</td>
      </tr>
      <tr>
        <td class="label" valign="top">cancel_return</td>
        <td>Optional</td>
        <td>An internet URL where the user will be returned if payment is cancelled. For example, a URL on your site which hosts a "Payment Cancelled" page. If if omitted, users will be taken to the PayPal site.</td>
      </tr>
      <tr>
        <td class="label" valign="top">a1</td>
        <td>Optional</td>
        <td>Trial amount 1. This is the price of the first trial period. For a free trial, use a value of 0</td>
      </tr>
      <tr>
        <td class="label" valign="top">p1</td>
        <td>Optional</td>
        <td>Trial period 1. This is the length of the first trial period. The number is modified by the trial period 1 units (t1, below).</td>
      </tr>
      <tr>
        <td class="label" valign="top">t1</td>
        <td>Optional</td>
        <td>Trial period 1 units. This is the units of trial period 1 (p1, above). Acceptable values are: D (days), W (weeks), M (months), Y (years).</td>
      </tr>
      <tr>
        <td class="label" valign="top">a2</td>
        <td>Optional</td>
        <td>Trial amount 2. This is the price of the second trial period.</td>
      </tr>
      <tr>
        <td class="label" valign="top">p2</td>
        <td>Optional</td>
        <td>Trial period 2. This is the length of the second trial period. The number is modified by the trial period 1 units (t2, below).</td>
      </tr>
      <tr>
        <td class="label" valign="top">t2</td>
        <td>Optional</td>
        <td>Trial period 2 units. This is the units of trial period 2 (p2, above). Acceptable values are: D (days), W (weeks), M (months), Y (years) (t2, below).</td>
      </tr>
      <tr>
        <td class="label" valign="top">a3</td>
        <td>Required</td>
        <td>Regular rate. This is the price of the subscription.</td>
      </tr>
      <tr>
        <td class="label" valign="top">p3</td>
        <td>Required</td>
        <td>Regular billing cycle. This is the length of the billing cycle. The number is modified by the regular billing cycle units (t3, below).</td>
      </tr>
      <tr>
        <td class="label" valign="top">t3</td>
        <td>Required</td>
        <td>Regular billing cycle units. This is the units of the regular billing cycle (p3, above) Acceptable values are: D (days), W (weeks), M (months), Y (years).</td>
      </tr>
      <tr>
        <td class="label" valign="top">src</td>
        <td>Optional</td>
        <td>Recurring payments. If set to "1," the payment will recur unless your customer cancels the subscription before the end of the billing cycle. If omitted, the subscription payment will not recur at the end of the billing cycle.</td>
      </tr>
      <tr>
        <td class="label" valign="top">sra</td>
        <td>Optional</td>
        <td>Reattempt on failure. If set to "1," and the payment fails, the payment will be reattempted two more times. After the third failure, the subscription will be cancelled. If omitted and the payment fails, payment will not be reattempted and the subscription will be immediately cancelled.</td>
      </tr>
      <tr>
        <td class="label" valign="top">srt</td>
        <td>Optional</td>
        <td>Recurring Times. This is the number of payments which will occur at the regular rate. If omitted, payment will continue to recur at the regular rate until the subscription is cancelled.</td>
      </tr>
      <tr>
        <td class="label" valign="top">no_note</td>
        <td>Required</td>
        <td>This field makes sure your subscriber is not prompted to include a note with the subscription, a function which PayPal Subscriptions does not support. This field must be included, and the value must be set to 1.</td>
      </tr>
      <tr>
        <td class="label" valign="top">custom</td>
        <td>Optional</td>
        <td>User-defined field (maximum 255 characters) which will be passed through the system and returned to user in payment notification emails. This field will not be shown to your subscribers.</td>
      </tr>
      <tr>
        <td class="label" valign="top">invoice</td>
        <td>Optional</td>
        <td>User- defined field (maximum 127 characters) which must be unique with each subscription. The invoice number will be shown to subscribers with the other details of their transactions.</td>
      </tr>
      <tr>
        <td class="label" valign="top">usr_manage</td>
        <td>Optional</td>
        <td>Username and password generation field. If set to "1" PayPal will generate usernames and passwords for your subscribers. For use with Password Management (see page 33). If omitted, no passwords will be generated.</td>
      </tr>
      <tr>
        <td class="label" valign="top">cn</td>
        <td>Optional</td>
        <td>Label that will appear above the note field (maximum 30 characters). This value is not saved and will not appear in any of your notifications. If omitted, no variable will be passed back to you. "Special instructions (optional):" will be displayed.</td>
      </tr>
      <tr>
        <td class="label" valign="top">cs</td>
        <td>Optional</td>
        <td>Sets the background color of your payment pages. If set to "1," the background color will be black. If omitted or set to "0" the background color will be white.</td>
      </tr>
      <tr>
        <td class="label" valign="top">on0</td>
        <td>Optional</td>
        <td>First option field name (maximum 30 characters). If omitted, no variable will be passed back to you.</td>
      </tr>
      <tr>
        <td class="label" valign="top">os0</td>
        <td>Optional</td>
        <td>First set of option value(s). If this option is selected through a text box (or radio button), each value should be no more than 30 characters. If this value is entered by the customer through a text box, there is a 200- character limit. If omitted, no variable will be passed back to you. "on0" must be defined in order for "os1" to be recognized.</td>
      </tr>
      <tr>
        <td class="label" valign="top">on1</td>
        <td>Optional</td>
        <td>Second option field name (maximum 30 characters). If omitted, no variable will be passed back to you.</td>
      </tr>
      <tr>
        <td class="label" valign="top">os1</td>
        <td>Optional</td>
        <td>Second set of option value(s). If this option is selected through a text box (or radio button), each value should be no more than 30 characters. If this value is entered by the customer through a text box, there is a 200- character limit. If omitted, no variable will be passed back to you. "on1" must be defined in order for "os1" to be recognized.</td>
      </tr>
      <!--						<tr>
							<td class="label" valign="top">tax</td>
							<td>Optional</td>
							<td>Transaction-based tax override variable. Set to a flat
						tax amount you would like to apply to the transaction
						regardless of the buyer's location. If present, this value
						overrides any tax settings that may be set in the seller's
						Profile. If omitted, Profile tax settings (if any) will
						apply.</td>
						</tr>
-->
      <tr>
        <td class="label" valign="top">modify</td>
        <td>Optional</td>
        <td>Modification behavior. 0 or null = The button allows buyers to only create new subscriptions. 1 = The button allows buyers to modify current subscriptions if they have any and to sign up for new subscriptions if they do not. 2 = The button allows buyers only to modify existing subscriptions according to the other parameters specified by the button and does not allow sign-up for new subscriptions.</td>
      </tr>
      <tr>
        <td class="label" valign="top">page_style</td>
        <td>Optional</td>
        <td>Sets the Custom Payment Page Style for payment pages associated with this button/link. The value of page_style is the same as the Page Style Name you chose when adding or editing the page style. You can add and edit Custom Payment Page Styles from the Profile section of the My Account tab. If you would like the button/link to always reference the style you make Primary, set this variable equal to "primary." If you would like the button/link to reference the default PayPal page style, set this variable equal to "paypal." The page_style variable has a maximum length of 30 characters. Valid character set is alphanumeric ASCII lower 7-bit characters only, plus underscore. It cannot include spaces.</td>
      </tr>
    </tbody>
  </table>
  <!-- End HTML Variables for PayPal Subscriptions -->
</div>
<br>
<a name="HTMLVariablesforDisplayingPayPalPaymentPages"></a>
<h2>HTML Variables for Displaying PayPal Payment Pages</h2>
<div class="description">
  <p>HTML variables for displaying PayPal payment pages control how the pages appear and function.</p>
  <h5>HTML Variables: Display Information.</h5>
  <br>
  <!-- Begin HTML Variables: Display Information -->
  <table class="example-definition" width="100%">
    <thead>
      <tr>
        <td style="width: 20%;">Name</td>
        <td style="width: 55%;">Description</td>
        <td style="width: 20%;">Required or Optional</td>
        <td style="width: 5%;">Character Length</td>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="label">cancel_<br>
          return</td>
        <td>A URL to which the customer's browser is returned if payment is canceled; for example, a URL on your website that displays a "Payment Canceled" page.<br>
          <strong>Default</strong>: Browser is directed to the PayPal website. </td>
        <td>Optional</td>
        <td></td>
      </tr>
      <tr>
        <td class="label">cbt</td>
        <td>Sets the text for the Continue button on the PayPal <strong>Payment Complete</strong> page.<br>
            <br>
            <span class="emphasis note">Note:</span> The return variable must also be set.</td>
        <td>Optional</td>
        <td>60</td>
      </tr>
      <tr>
        <td class="label" valign="top">cn</td>
        <td>Label above the note field. This value is not saved and does not appear in any of your notifications. If omitted, no variable is passed back to you.</td>
        <td>Optional</td>
        <td>40</td>
      </tr>
      <tr>
        <td class="label">cpp_header_<br>
          image</td>
        <td>Sets the image at the top left of the payment page. The image's maximum size is 750 pixels wide by 90 pixels high, and it must be URL-encoded. PayPal recommends that you provide an image that is stored only on a secure server (https).</td>
        <td>Optional</td>
        <td>No limit</td>
      </tr>
      <tr>
        <td class="label">cpp_<br>
          headerback_<br>
          color</td>
        <td>Sets the background color for the header of the payment page.<br>
          Valid value is case-insensitive six-character HTML hexadecimal color code in ASCII. </td>
        <td>Optional</td>
        <td></td>
      </tr>
      <tr>
        <td class="label">cpp_<br>
          headerborder_<br>
          color</td>
        <td>Sets the border color around the header of the payment page.<br>
          The border is a two-pixel perimeter around the header space, which has a maximum size of 750 pixels wide by 90 pixels high. Valid value is case-insensitive six-character HTML hexadecimal color code in ASCII. </td>
        <td>Optional</td>
        <td></td>
      </tr>
      <tr>
        <td class="label">cpp_payflow_<br>
          color</td>
        <td>Sets the background color for the payment page below the header. Valid value is case-insensitive six-character HTML hexadecimal color code in ASCII.<br>
          <br>
          <span class="emphasis note">Note:</span> Background colors that conflict with PayPal's error messages are not allowed; in these cases, the default color is white.</td>
        <td>Optional</td>
        <td></td>
      </tr>
      <tr>
        <td class="label">cs</td>
        <td>Sets the background color of your payment pages.<br>
          Default or 0 = background color is white.<br>
          1 = background color is black. </td>
        <td>Optional</td>
        <td></td>
      </tr>
      <tr>
        <td class="label">image_url</td>
        <td>The URL of the 150x50-pixel image displayed as your logo in the upper left corner of PayPal's pages. Must be URL-encoded.<br>
          Default: your business name (if you have a Business account) or your email address (if you have Premier account). </td>
        <td>Optional</td>
        <td></td>
      </tr>
      <tr>
        <td class="label" valign="top">lc</td>
        <td>Sets the default country and associated language for the login or signup page that buyers see when they click your button. If this variable is absent, the default will be set from the user's cookie, or will be set to the U.S. if there is no cookie. Can be set to any of the countries currently available on PayPal.</td>
        <td>Optional</td>
        <td></td>
      </tr>
      <tr>
        <td class="label">no_note</td>
        <td>Prompt customer to include a note with payment.<br>
          Default or 0: customer is prompted to include a note.<br>
          1: customer is not prompted to include a note. </td>
        <td>Optional</td>
        <td>1</td>
      </tr>
      <tr>
        <td class="label">no_shipping</td>
        <td>Prompt customer for shipping address.<br>
          Default or 0: customer is prompted to include a shipping address.<br>
          1: customer is not asked for a shipping address.<br>
          2: customer must provide a shipping address. </td>
        <td>Optional</td>
        <td>1</td>
      </tr>
      <tr>
        <td class="label">page_style</td>
        <td>Sets the Custom Payment Page Style for payment pages associated with this button/link. Alphanumeric ASCII lower 7-bit characters only, plus underscore. No spaces.<br>
          <i>somePageStyleName</i>: The name of a page style you have defined.<br>
          primary: always use the page style set as primary.<br>
          paypal: use the PayPal default style. </td>
        <td>Optional</td>
        <td>30</td>
      </tr>
      <tr>
        <td class="label">return</td>
        <td>The URL to which the customer's browser is returned after completing the payment; for example, a URL on your site that displays a "Thank you for your payment" page.<br>
          Default: customer is taken to the PayPal website. </td>
        <td>Optional</td>
        <td></td>
      </tr>
      <tr>
        <td class="label">rm</td>
        <td>Return method GET or POST: the FORM METHOD used to send data to the URL specified by the return variable after payment completion.<br>
          <br>
          <span class="emphasis note">Note:</span> The rm variable takes effect only if the return variable is also set.<br>
          <br>
          Default or 0: GET method is used for all Shopping Cart transactions.<br>
          1: GET. The customer's browser is redirected to the return URL by the GET method, and no transaction variables are sent.<br>
          2: POST. The customer's browser is redirected to the return URL by the POST method, and all transaction variables are also posted. </td>
        <td>Optional</td>
        <td></td>
      </tr>
    </tbody>
  </table>
  <!-- End HTML Variables: Display Information -->
</div>
<br>
<a name="HTMLVariablesforPrepopulatingPayPalPaymentPages"></a>
<h2>HTML Variables for Prepopulating PayPal Payment Pages</h2>
<div class="description">
  <p>HTML variables for prepopulating PayPal payment pages let you specify information about the payer.</p>
  <h5>HTML Variables for Prepopulating Payment Pages with Buyer Information</h5>
  <br>
  <!-- Begin HTML Variables: Prepopulating PayPal FORMs or Address Overriding -->
  <table class="example-definition" width="100%">
    <thead>
      <tr>
        <td style="width: 15%;">Variable</td>
        <td style="width: 40px;">Description</td>
        <td style="width: 30%;">Requirements</td>
        <td style="width: 15%;">Character Limit</td>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="label" valign="top">address1</td>
        <td>Street (1 of 2 fields)</td>
        <td>Alphanumeric</td>
        <td>100</td>
      </tr>
      <tr>
        <td class="label" valign="top">address2</td>
        <td>Street (2 of 2 fields)</td>
        <td>Alphanumeric</td>
        <td>100</td>
      </tr>
      <tr>
        <td class="label" valign="top">city</td>
        <td>City</td>
        <td>Alphanumeric</td>
        <td>40</td>
      </tr>
      <tr>
        <td class="label" valign="top">country</td>
        <td>Sets shipping and billing country. </td>
        <td>Alphabetic </td>
        <td>2</td>
      </tr>
      <tr>
        <td class="label" valign="top">email</td>
        <td valign="top">Email address, used for new PayPal accounts.</td>
        <td valign="top">Alphanumeric</td>
        <td>127</td>
      </tr>
      <tr>
        <td class="label" valign="top">first_name</td>
        <td>First name</td>
        <td>Alphabetic</td>
        <td>32</td>
      </tr>
      <tr>
        <td class="label" valign="top">last_name</td>
        <td>Last name</td>
        <td>Alphabetic</td>
        <td>32</td>
      </tr>
      <tr>
        <td class="label" valign="top">night_<br>
          phone_a</td>
        <td>The area code for U.S. phone numbers, or the country code for phone numbers outside the U.S. This will prepopulate the buyer's home phone number.</td>
        <td>Numeric</td>
        <td> </td>
      </tr>
      <tr>
        <td class="label" valign="top">night_<br>
          phone_b</td>
        <td>The three-digit prefix for U.S. phone numbers, or the entire phone number for phone numbers outside the U.S., excluding country code. This will prepopulate the buyer's home phone number.</td>
        <td>Numeric</td>
        <td> </td>
      </tr>
      <tr>
        <td class="label" valign="top">night_<br>
          phone_c</td>
        <td>The four-digit phone number for U.S. phone numbers. This will prepopulate the buyer's home phone number.</td>
        <td>Numeric</td>
        <td>4</td>
      </tr>
      <tr>
        <td class="label" valign="top">state</td>
        <td>State</td>
        <td>Must be two-character official U.S. or Canadian abbreviation.</td>
        <td>2</td>
      </tr>
      <tr>
        <td class="label" valign="top">zip</td>
        <td>Postal code</td>
        <td>Numeric</td>
        <td>32</td>
      </tr>
    </tbody>
  </table>
</div>

</body>
</html>
Return current item: Paypal Class