hapi-zebra

Use Stripe in server routes

This hapi plugin adds an instance of the Stripe SDK to your server so you can easily integrate payments in your app.

Why?

• Validates your settings (e.g. API keys).
• Allows you to set the Stripe SDK and API versions.
• Simplifies your routes.

Install

npm install hapi-zebra stripe

Usage

Register the plugin on your server to make the stripe library available in routes.

const hapi = require('@hapi/hapi');
const zebra = require('hapi-zebra');

const server = hapi.server();

const init = async () => {
    await server.register({
        plugin  : zebra,
        options : {
            secretKey : process.env.STRIPE_SECRET_KEY
        }
    });
    server.route({
        method : 'POST',
        path   : '/charge',
        async handler(request) {
            const { stripe } = request.server;

            await stripe.subscriptions.create({
                plan     : 'some-plan-name',
                customer : 'some-user-id',
                source   : request.payload.stripeToken
            });
            return 'Thanks for paying!';
        }
    });
    await server.start();
    console.log('Server ready:', server.info.uri);
};

init();

Note that hapi-zebra will use the version of the Stripe SDK that is in your package.json.

API

Please see Stripe's API documentation for details on the stripe library itself.

Plugin options

Type: object

The options are passed to new Stripe() to configure the Stripe client. See the Stripe SDK for details on the available options, such as apiVersion.

apiVersion

Type: string

Set a specific Stripe API version to use for all requests, overriding your account's default setting.

secretKey

Type: string

Your secret Stripe API key, used to authenticate with Stripe when using its API.

Decorations

For convenience, this plugin adds the following API to the hapi server instance.

server.stripe

An instance of the Stripe SDK, which has methods to make requests to the Stripe API. This is available as request.server.stripe inside of route handlers.

Contributing

See our contributing guidelines for more details.

1. Fork it.
2. Make a feature branch: git checkout -b my-new-feature
3. Commit your changes: git commit -am 'Add some feature'
4. Push to the branch: git push origin my-new-feature
5. Submit a pull request.

License

MPL-2.0 © Seth Holladay

Go make something, dang it.