====== PayPal ======
The PayPal field allows a software developer to show a button that initiates a PayPal Express Checkout payment session.  Options are available to define a single line item to pay for with Pay Pal inside the PayPal pages in a popup window.  PayPal's page that will open defaults to the "no PayPal account" option so credit card information can be provided.  It is still possible for the end user to pay with their PayPal account if they so choose, and only instant payment methods will be accepted.  To read more about PayPal Express Checkout including fees visit [[https://www.paypal.com/webapps/mpp/express-checkout|https://www.paypal.com/webapps/mpp/express-checkout.]]

This field does not have a stored value and will not run save actions or interface actions.

===== How to Create =====
  - Click the {{:presentation-layer:field-plus.png|}} to add a field in your [[Form|form]].
  - Choose "New Field"
  - Select the table you wish to add the field to. Most of the time this will be the current [[Table|table]] you are on, called the current [[Context|context]].
  - Enter a field name and click "Choose Type".
  - Choose "PayPal" from the list of field types.
  - You will be prompted to provide [[Expression Builder|expressions]] that will define the critical values required to processes a PayPal Payment.
  - You can continue adding fields or click the "Select" button to finish adding.
  - After the field is added to the screen edit the configuration to add the details of the PayPal configuration.


===== Features =====
==== Field Label ====
  * [[Field Setting - Field Label|Field Label]]
  * [[Field Setting - Display Alternate Label]] (affects this form only)
==== Grid Appearance ====
  * [[Field Setting - Column Span|Column Span]]
  * [[Field Setting - Row Span|Row Span]]
  
==== Tooltip ====
  * [[Field Setting - Tooltip|Tooltip]]
  * [[Field Setting - Descriptive Text|Descriptive Text]]
  * [[Field Setting - Display Alternate Descriptive Text|Display Alternate Descriptive Text]] (affects this form only)

==== Block Association ====
  * [[Field Setting - Temporary Block Association|Temporary Block Association]]
  * [[Field Setting - Global Block Association|Global Block Association]]

==== PayPal Credentials ====
  * [[Field Setting - PayPal API Username|PayPal API Username]]
  * [[Field Setting - PayPal API Password|PayPal API Password]]
  * [[Field Setting - PayPal API Signature|PayPal API Signature]]

==== PayPal Charge ====
  * [[Field Setting - Payment Type|Payment Type]]
  * [[Field Setting - Order Total|Order Total]]
  * [[Field Setting - Order Item Title|Order Item Title]]
  * [[Field Setting - Currency|Currency]]
  * [[Field Setting - Item Total|Item Total]]
  * [[Field Setting - Shipping Total|Shipping Total]]
  * [[Field Setting - Shipping Discount|Shipping Discount]]
  * [[Field Setting - Handling Total|Handling Total]]
  * [[Field Setting - Tax Total|Tax Total]]
  * [[Field Setting - Billing Agreement Description|Billing Agreement Description]]

==== PayPal Checkout Page ====
  * [[Field Setting - Payment Page Cart Border Color|Payment Page Cart Border Color]]
  * [[Field Setting - Payment Page Brand Name|Payment Page Brand Name]]
  * [[Field Setting - Payment Page Logo|Payment Page Logo]]
  * [[Field Setting - Payment Page Customer Service Phone Number|Payment Page Customer Service Phone Number]]

===== Payment Processing =====
When a single payment or billing agreement is made they will be automatically redirected to a page in WorkXpress that shows a "Processing" message.  This page will look for an incoming [[Enterprise Service Bus|ESB Profile]] setup to [[Enterprise Service Bus - PayPal Express Checkout|receive and process Paypal payments]] or [[enterprise service bus - paypal refrence transaction| receive billing agreement details]].