summaryrefslogtreecommitdiff
path: root/billing/README.md
diff options
context:
space:
mode:
authorelijah <elijah@riseup.net>2013-12-18 00:10:01 -0800
committerelijah <elijah@riseup.net>2013-12-20 10:56:01 -0800
commit34ac576bf7efbddac0a89731292eac8974f95114 (patch)
treeedc2b821602e5ea0310ae185eef4e9d6e710c843 /billing/README.md
parent76517637ddf70577bd2a14bebb8a57552fbb1776 (diff)
enable billing engine by default, consolidate APP_CONFIG[:payments] and APP_CONFIG[:braintree] into APP_CONFIG[:billing][:braintree]
Diffstat (limited to 'billing/README.md')
-rw-r--r--billing/README.md49
1 files changed, 49 insertions, 0 deletions
diff --git a/billing/README.md b/billing/README.md
new file mode 100644
index 0000000..3ef6153
--- /dev/null
+++ b/billing/README.md
@@ -0,0 +1,49 @@
+Billing Engine
+====================
+
+Currently, this engine support billing via Braintree. More backends to come later.
+
+Configuration
+----------------------------------
+
+Start with a sandbox account, which you can get here: https://www.braintreepayments.com/get-started
+
+Once you have registered for the sandbox, logging in will show you three important variables you will need to configure:
+
+* merchantId
+* publicKey
+* privatekey
+
+To configure the billing engine, edit `config/config.yaml` like so:
+
+ production: (or "development", as you prefer)
+ billing:
+ braintree:
+ environment: sandbox
+ merchant_id: Ohp2aijaaqu6oJ4w
+ public_key: ahnar0UwLahwe6Ce
+ private_key: aemie2Geohgah2EaOad9DeeruW4Iegh4
+
+If deploying via puppet, the same data in webapp.json would like this:
+
+ "billing": {
+ "braintree": {
+ "environment": "sandbox",
+ "merchant_id": "Ohp2aijaaqu6oJ4w",
+ "public_key": "ahnar0UwLahwe6Ce",
+ "private_key": "aemie2Geohgah2EaOad9DeeruW4Iegh4"
+ }
+ }
+
+Now, you should be able to add charges to your own sandbox when you run the webapp.
+
+The acceptable values for `billing.braintree.environment` are: `development`, `qa`, `sandbox`, or `production`.
+
+Plans
+--------------------------------
+
+You also will want to add a Plan to your Sandbox. Within the Braintree Sandbox, navigate to 'Recurring Billing' -> 'Plans'. From here, you can add a new Plan. The values of the test plan are not important, but the ID will be displayed, so should pick something descriptive.
+
+Here are credit cared numbers to try in the Sandbox:
+
+https://www.braintreepayments.com/docs/ruby/reference/sandbox \ No newline at end of file