===== Purpose =====
This [[Enterprise Service Bus]] system allows a Software Developer to receive a Billing Agreement ID from a PayPal Express Checkout and store the returned data on a [[Record|record]] in WorkXpress.  Typically a Software Developer will create a PayPal Billing Agreement [[Table|table]] that contains the agreement data for an individual customer.

===== End User Experience =====
A User of a WorkXpress Application that utilizes the PayPal Reference Transaction Enterprise Service Bus functionality will need to authorize a PayPal billing agreement that was initiated via a [[Field Type - PayPal|PayPal field]].  After the agreement is completed the User will be redirected to a WorkXpress Application page where the data will be gathered by WorkXpress.

===== What Data is stored in WorkXpress? =====

The following pieces of data are available:

  * **PayPal Express Checkout Token** - The PayPal Express Checkout Token identifies this Payment.  This Token must be stored in order to prevent duplicate record creation.
  * **PayPal Billing Agreement ID** - This id is the PayPal Billing Agreement ID that is used to create transactions.

If any of these values are not configured to be stored in the WorkXpress application then the data will be lost.
===== Data Sources =====

The data source selection for an Incoming ESB Profile will determine what helpers and configuration is needed and or available.

  * [[Enterprise Service Bus Data Source - PayPal Billing Agreement Return|PayPal Express Billing Agreement Return]]