West Virginia Finance

Sep 21 2017

HTML Variables for PayPal Payments Standard – PayPal Developer #how #to #setup #a #paypal #shopping


#

HTML Variables for PayPal Payments Standard

PayPal Payments Standard payment buttons and the Cart Upload command support the following HTML variables.

Technical variables

Technical HTML variables control how PayPal responds technically when people click PayPal payment buttons or when third-party shopping carts or solution providers initiate payment processing with the Cart Upload command. They also control how your buttons interact with special PayPal features.

Note: Use the HTML IMG tag to display the button on your web page. For a list of PayPal hosted buttons, see PayPal buttons, logos, and marks .

Valid values for the cmd variable

The button that the person clicked was a Buy Now button.

For shopping cart purchases. The following variables specify the kind of shopping cart button that the person clicked:

  • add. Add to Cart buttons for the PayPal Shopping Cart
  • display. View Cart buttons for the PayPal Shopping Cart
  • upload. The Cart Upload command for third-party carts

The button that the person clicked was a Subscribe button.

The button that the person clicked was an Automatic Billing button.

The button that the person clicked was an Installment Plan button.

The button that the person clicked was a Donate button.

The button that the person clicked was protected from tampering by using encryption, or the button was saved in the merchant s PayPal account. PayPal determines which kind of button was clicked by decoding the encrypted code or by looking up the saved button in the merchant s account.

HTML variables for special PayPal features

The cardinal number of the option field, on0 through on9. that has product options with different prices for each option. Include option_index if the option field with prices is not on0 .

  • Optional for Buy Now, Add to Cart, Subscribe, Automatic Billing, and Installment Plan buttons.

Not used with Donate buttons.

For priced options, the value of the first option selection of the on0 dropdown menu. The values must match exactly:

  • Optional for Buy Now, Add to Cart, Subscribe, Automatic Billing, and Installment Plan buttons.

Not used with Donate buttons.

For priced options, the amount that you want to charge for the first option selection of the on0 dropdown menu. Use only numeric values; the currency is taken from the currency_code variable. For example:

  • Optional for Buy Now, Add to Cart, Subscribe, Automatic Billing, and Installment Plan buttons.

Not used with Donate buttons.

For priced options, the value of the second option selection of the on0 dropdown menu. For example:

You can specify a maximum of 10 option selections by incrementing the option selection index ( option_select0 through option_select9 ).

Note: You must also set a corresponding os0 option selection.

  • Optional for Buy Now, Add to Cart, Subscribe, Automatic Billing, and Installment Plan buttons.

Not used with Donate buttons.

For priced options, the amount that you want to charge for the second option selection of the on0 dropdown menu. For example:

You can specify a maximum of 10 option amounts by incrementing the option amount index ( option_amount0 through option_amount9 ).

Note: You must also set a corresponding os0 option selection.

  • Optional for Buy Now, Add to Cart, Subscribe, Automatic Billing, and Installment Plan buttons.

Not used with Donate buttons.

Payment transaction variables

Payment transaction variables provide information about entire payments, regardless of the individual items involved with the payment. You can use these variables with Add to Cart buttons and the Cart Upload command.

Indicates whether the payment is a final sale or an authorization for a final sale, to be captured later.

Valid value is sale. authorization. or order .

Default is sale. To place a hold on the PayPal account for the authorized amount, set this value to authorization. To authorize the payment without placing a hold on the PayPal account, set this value to order .

Important: If you set paymentaction to order. use the Authorization Capture API to authorize and capture the payment payments. The Merchant Services on the PayPal website let you capture payments only for authorizations but not for orders.

The quantity associated with item x that is uploaded from a shopping cart. To pass an aggregate quantity for the entire cart, use quantity_1 .

Specify whether to let buyers enter maximum billing limits in a text box or choose from a list of maximum billing limits that you specify.

  • max_limit_own. your button displays a text box for buyers to enter their own maximums above a minimum billing limit that you set with the min_amount variable.
  • max_limit_defined. your button displays a dropdown menu of product options with prices to let buyers choose their maximum billing limits.

The minimum monthly billing limit, if you have one. Valid only if set_customer_limit = max_limit_own .

Installment Plan variables

Display the total payment amount to buyers during checkout

  • Y. Display the total.
  • N. Do not display the total.
  • If the button offers a single plan, use 0, or use a number not used for option fields without prices, such as size and color.
  • If the button offers plan options, the cardinal number of the option field, on0 through on9. with plan payment options.

Include option_index if the number for the single plan or options field is not 0 .

If the button offers a single plan, the value attribute of a hidden input field named os n. The value attributes of both elements must match:

If the button offers plan options, the value attribute of the radio button for plan option n. The value attributes of both elements must match:

option_select n _name

  • If the button offers plan options, text next to the radio button for plan option n .
  • If the button offers a single plan, text that describes the plan features.

For example, you might text Pay in 4 installments .

option_select n _type

Whether the single plan or plan option n offered by the button is paid in full, in equal periods, or in variable periods.

  • F. Pay in full, at checkout.
  • E. Pay in equal periods, beginning at checkout or sometime later.
  • V. Pay in variable periods, beginning at checkout.

option_select n _a m

Sets the text for the Return to Merchant button on the PayPal Payment Complete page. For Business accounts, the return button displays your business name in place of Merchant. by default. By default, the text reads Return to donations coordinator for Donate buttons.

Note: The cbt variable takes effect only if the return variable is set.

Related to the no_note variable. When no_note is 0. a text box is displayed at checkout for buyers who would like to include any special instructions. Use the cn field to enter a custom note or label for this text box, such as, Enter any special instructions.

The HTML hex code for your principal identifying color. PayPal blends your color to white in a gradient fill that borders the cart review area of the PayPal checkout user interface.

Valid value is 6 single-byte hexadecimal characters that represent an HTML hex code for a color.

  • Valid only for Buy Now and Add to Cart buttons and the Cart Upload command.

Not used with Subscribe or Donate buttons.

The image at the top left of the checkout page. The image s maximum size is 750 pixels wide by 90 pixels high. PayPal recommends that you provide an image that is stored only on a secure (https) server.

For more information, see Customize PayPal Checkout Pages in the Merchant Setup and Administration Guide.

Deprecated for Buy Now and Add to Cart buttons and the Cart Upload command.


Written by admin


Leave a Reply

Your email address will not be published. Required fields are marked *