checkbook-api

Checkbook.io Node.js Library

The Checkbook.io Node library provides convenient access to the Checkbook.io API from applications written in server-side JavaScript.

Installation

Install the package with:

npm install checkbook-api --save

Configuration

The package needs to be configured with your account's API Key and API Secret:

var CheckbookAPI = require('checkbook-api');
var Checkbook = new CheckbookAPI({
	api_key: 'd6aa2703655f4ba2af2a56202961ca86',
	api_secret: 'dXbCgzYBMibj8ZwuQMd2NXr6rtvjZ8',
	env: 'test'
});

The env parameter is optional and can be omitted if the requests are made to the live environment.
The possible values for this parameter are test or sandbox and the API credentials need to be from the specified environment.

You can get the API Key and API Secret values from the Settings page:

Usage

You can use the following code snippet to send a digital check:

Checkbook.checks.sendDigitalCheck({
    name: 'Widgets Inc.',
    recipient: '[e-mail]',
    description: 'Test Send Check',
    amount: 10.00
}, function (error, response) {
    if (error) {
        console.log('Error:', error);
    } else {
        console.log(response);
    }
});

You can use the following code snippet to query the list of checks:

Checkbook.checks.list({
    page: 2,
    per_page: 10,
    status: 'IN_PROCESS'
}, function (error, response) {
    if (error) {
        console.log('Error:', error);
    } else {
        console.log(response);
    }
});

Methods reference

The Checkbook class has several endpoints and you can find the detailed reference for the methods each one provide here:

• Checkbook.checks
  • list()
  • sendDigitalCheck()
• Checkbook.invoices
  • list()
• Checkbook.subscriptions
• Checkbook.banks
• Checkbook.users

Getting help

If you need help installing or using the library, please contact Checkbook.io Support at [e-mail].

If you've instead found a bug in the library or would like new features added, please open issues or pull requests against this repo.

More Information

• API Endpoints

• Error Codes

• Idempotency