Node.js SDK for connecting to the Settle Payment Platform

Start accepting payments via Settle in seconds ✨

An easy to use SDK for Node.js with all the best practices to kickstart your integration with the Settle Payment Platform.

Features

This SDK is divided into two parts:

• Client — Simplifies calling the Settle API by handling request signing and authorization.
• Handler — Express.js compatible middleware that verifies signatures of incoming callbacks from Settle.

Usage

Step 1 — Install the SDK

Add the settle-sdk-node NPM package to you project.

npm i settle-sdk-node

Step 2 — Configure the SDK

In your projects root folder, create a file named config.js containing the following code:

module.exports = {
    environment: string, // 'sandbox' or 'production'
    user: string, // can be obtained by contacting Settle
    merchantId: string, // can be obtained by contacting Settle
    authentication: {
        sandbox: {
            priv: string, // RSA Private Key
            pub: string // RSA Public Key
        },
        production: {
            priv: string, // RSA Private Key
            pub: string // RSA Public Key
        }
    }
}

Step 3 — Initialize the Handler Function

const { handler } = require('settle-sdk-node')
app.use(handler('sandbox'))
app.post( '/', ( req, res, next ) => {
    console.log( 'Settle says:\n%s', req.body );
    res.sendStatus( 200 );
});

Step 4 — Using Client Functions

method.function().then(success, failure)

const settle = require('settle-sdk-node');
const merchant = settle.merchant;

merchant.api_keys.list()
  .then((success) => {
    console.log(success);
  }, (failure) => {
    throw new Error(failure)
  });

For a full overview of all available Client Functions, see our article on how to use Client Functions in the Settle SDK for Node.js.

Open Source and Contribution

The SDK is Open Source, licensed under the Apache 2 license. If you would like to contribute to the SDK, please feel free to fork the repo and send us a pull request. Or if you have a comment, question, or suggestion for improvements, please raise an issue.

License

Apache 2 © Settle Group / Christian Wick