diff --git a/README.txt b/README.txt
new file mode 100644
index 0000000..55fd763
--- /dev/null
+++ b/README.txt
@@ -0,0 +1,33 @@
+COMMERCE PAYPAL
+===============
+
+PayPal integration for the Drupal Commerce payment and checkout system. Currently supports PayPal WPS for redirected payment using the latest Commerce dev version. IPN support covers authorizations, captures, voids, and refunds with full logging for testing and debugging.
+
+Sponsored by Commerce Guys.
+
+Supported Features
+------------------
+This project includes a base module that defines some helper functions and a listener for PayPal Instant Payment Notifications (IPNs). Each payment method offered by PayPal is enabled via its own module:
+
+- PayPal Website Payments Standard (WPS) - redirects from checkout to PayPal and includes IPN support for authorizations during checkout, prior authorization captures, authorizations plus capture during checkout ("Sale"), voids, and refunds. E-check may be supported, but I can't currently test it with my sandbox account.
+
+- PayPal Website Payments Pro (WPP) - supports authorization and authorization plus capture during checkout ("Sale"). Authorization only transactions must be captured at PayPal, but IPN support has not been added yet to mark pending authorization transactions as complete locally.
+
+- PayPal Express Checkout (EC) - not implemented yet.
+
+For a comparison of Website Payment Standard (WPS) and Website Payment Professional (WPP), see https://merchant.paypal.com/us/cgi-bin/?cmd=_render-content&content_ID=merchant/compare_wp_products#secondpage
+
+Installation and Configuration
+------------------------------
+- Install the PayPal modules and the specific payment method modules you intend to use.
+
+- Enable the default Rule for each desired payment method via Store > Configuration > Payment methods.
+
+- For each payment method, edit the enabled action within the rule.  Configuration options for each payment method are discussed in the README.txt for that method.
+
+
+Important Considerations
+-------------------------
+- During development, you should use the sandbox if possible and may also want to turn on full Instant Payment Notification (IPN) logging to log all IPN activity to the watchdog and ensure IPN's are received and processed as expected.
+
+*** You will only receive IPNs from PayPal if you do your testing on a public web server that PayPal can actually POST to. Installations on your localhost will not be accessible by PayPal, so your PayPal WPS payments will never appear on your orders. ***
\ No newline at end of file
diff --git a/modules/wpp/README.txt b/modules/wpp/README.txt
new file mode 100644
index 0000000..de3077c
--- /dev/null
+++ b/modules/wpp/README.txt
@@ -0,0 +1,33 @@
+COMMERCE PAYPAL WEBSITE PAYMENTS PROFESSIONAL (WPP)
+===================================================
+
+Configuration Options
+----------------------
+ORDER
+- Data selector
+  Unless you're really, really sure you know what you're doing, just leave it alone.
+
+PAYMENT SETTINGS
+- API username
+
+- API password
+
+- Signature
+
+- PayPal server
+  For development or testing, set this to the Sandbox option.  Set to Live for production deployment.
+
+- Limit accepted credit cards to the following types
+  Select one or more options from the provided list of credit cards which may be accepted.  Note that cards may be subject to limitations by geographical location (e.g., American Express is not availabe in the UK) or by currency code (e.g., Maestro and Solo can only accept GBP).
+
+- Require the card security code to process credit card transactions
+  Select this option if the client must enter the security code from their credit card.  This setting should match that set in the PayPal account being used.
+
+- Currency code
+  Select the type of currencty which will be accpted for this payment method.
+
+- Default credit card transaction type
+  Select "Authorization and capture" if the funds should be charged immediately (e.g., the client is buying something) or "Authorization only" to put a hold against the funds (e.g., if the client is reserving a room).
+
+- Log the following message for debugging
+  Select which API interactions should be logged to Watchdog.
\ No newline at end of file
diff --git a/modules/wps/README.txt b/modules/wps/README.txt
new file mode 100644
index 0000000..6539aae
--- /dev/null
+++ b/modules/wps/README.txt
@@ -0,0 +1,24 @@
+COMMERCE PAYPAL WEBSITE PAYMENTS STANDARD (WPS)
+===============================================
+
+Configuration Options
+----------------------
+ORDER
+- Data selector
+  Unless you're really, really sure you know what you're doing, just leave it alone.
+
+PAYMENT SETTINGS
+- PayPal e-mail address
+  The email address for the PayPal accont which will be used to received payments.
+
+- Currency code
+  Select the type of currencty which will be accpted for this payment method.
+
+- PayPal server
+  For development or testing, set this to the Sandbox option.  Set to Live for production deployment.
+
+- Payment action
+  Select Sale if the funds should be charged immediately or Authorization to put a hold against the funds (e.g., if the client is reserving a room).
+
+- IPN logging
+  Select the desired level of logging of Instant Payment Notifications (IPNs) sent by PayPal to the site.
\ No newline at end of file