@panda-clouds/stripe

PCStripe

maintained by PandaClouds.com

PCStripe provides a clean way to validate data in Parse Sever Cloud Code.

Installation

1. If you want to use this library, you first need to install the Node.js.

2. When you install node.js, will also be installed npm.

3. Please run the following command.

npm install --save @panda-clouds/stripe

API Keys

Problem: It's a bad secuirty practice to commit our Stripe API Keys to this repo.

Solution: we have devised a system for each user to create a .gitignored file called 'apiKeys.js' that contains your specific keys. Run these commands to create the boiler plate "apiKeys.js" file. Git should never ask you to commit this file.

1. open terminal.
2. cd /my/path/to/proj
3. echo -e "module.exports = function() {\n\tprocess.env.STRIPE_SECRET_KEY = 'sk_test_123';\n\tprocess.env.STRIPE_CLIENT_ID = 'ca_123';\n\tprocess.env.STRIPE_REFRESH_TOKEN = 'rt_123';\n\tprocess.env.STRIPE_AUTH_CODE = 'ac_123';\n};\n" > apiKeys.js
4. open the file and replace sk_test_123 with your key, etc

Usage

Node.js

const PCStripe = require('@panda-clouds/stripe');


// example usage

You can replace PCStripe with any variable.

Methods

Unit Tests are an additional resource for learning functionality.

- mustExist()

requires the property to be set, else throws error

Example:

Parse.Cloud.beforeSave('Book', request =>{
	const data = new PCStripe(request);
	data.prop('title').mustExist();    // will throw Error if request.object.get('title') doesn't exist
});

- getUserIdFromStripe(auth_code)

Using the stripe authentication code, retrieves the user data for the user in the OAuth workflow.

args: auth_code: stripe authentication code provided by OAuth workflow.

return: json object with user details.

Example:

const stripe = new PCStripe('shhh_secret_key');
const response = await stripe.getUserIdFromStripe('auth_code');

- getUserIdFromStripeRefresh(refresh_token)

Using the refresh token, retrieves the user data for the user in the oauth workflow.

args: refresh_token: refresh token provided by getUserIdFromStripe for re-use after auth code expires.

return: json object with user details.

Example:

const stripe = new PCStripe('shhh_secret_key');
const response = await stripe.getUserIdFromStripeRefresh('refresh_token');

- transferToConnectedAccount(dest_acct_id, payment_amount, group_id)

Transfer funds to a connected stripe account.

args: dest_acct_id: stripe account id of the account to transfer funds into. payment_amount: amount in cents(USD) to transfer. group_id: used for book keeping purposes in order for transactions to be grouped together. return: json object returned by stripe regarding transaction.

Example:

const stripe = new PCStripe('shhh_secret_key');
const response = await stripe.transferToConnectedAccount('acct_lnm', 350, 'lnm_payout_group');

Contributions

Pull requests are welcome! here is a checklist to speed things up:

• modify PCStripe.js
• add unit tests in PCStripe.spec.js
• run npm test
• document method in README.md
• add your name to 'Contributors' in README.md

Contributors

(Add your name)

• [*] Marc Smith