Skip to content
Go to GoCardless homepage
LoginSign up

Our new API docs and Node library

By Alasdair MonkNov 20131 min read

I'm excited to announce the release of our rewritten and redesigned API docs at

We've rethought our documentation to provide more clarity and a better understanding of the core concepts of GoCardless. We've also added more example code for each of our official client libraries.

To help improve our documentation even more we're also making it open source.

New Node library

Swiftly following the joy of fresh, cleanly formatted docs I have the pleasure of introducing our new API library for Node.

Let's cut straight to creating a one off bill:

var url = gocardless.bill.newUrl({
  amount: '10.00',
  name: 'Coffee',
  description: 'One bag of single origin coffee'

// Now redirect to `url`

... or perhaps a subscription (we really like our coffee)

var url = gocardless.subscription.newUrl({
  amount: '30.00',
  interval_length: '1',
  interval_unit: 'month',
  name: 'Coffee',
  description: 'Fresh roast coffee subscription'

// Now redirect to `url`

Our Node library is currently in beta, so please get in touch if you experience any unexpected behaviour. For more example usage and documentation, please check out the Node library docs.

Open source and available today

Naturally, both our new API docs and Node client library are open source, and available on GitHub today.

This is also an opportune moment to say that we're hiring. If you love working on big problems then help us fix online payments.

We're hiring software developers

See job listings

GoCardless makes it easy to collect recurring payments

Sign upContact sales

Interested in automating the way you get paid? GoCardless can help

Contact sales

Contact Us


Contact sales

+44 20 8338 9539


Request support

+44 20 8338 9540

Seen 'GoCardless Ltd' on your bank statement? Learn more

GoCardless Ltd., Sutton Yard, 65 Goswell Road, London, EC1V 7EN, United Kingdom

GoCardless (company registration number 07495895) is authorised by the Financial Conduct Authority under the Payment Services Regulations 2017, registration number 597190, for the provision of payment services. GoCardless SAS (23-25 Avenue Mac-Mahon, Paris, 75017, France), an affiliate of GoCardless Ltd (company registration number 834 422 180, R.C.S. PARIS), is authorised by the ACPR (French Prudential Supervision and Resolution Authority), Bank Code (CIB) 17118, for the provision of payment services.