mollie-api-node

Mollie API client for Node

Accepting iDEAL, Bancontact/Mister Cash, SOFORT Banking, Creditcard, SEPA Bank transfer, SEPA Direct debit, Bitcoin, PayPal, Belfius Direct Net and paysafecard online payments without fixed monthly costs or any punishing registration procedures. Just use the Mollie API to receive payments directly on your website or easily refund transactions to your customers.

Requirements

To use the Mollie API client, the following things are required:

• Get yourself a free Mollie account. No sign up costs.
• Create a new Website profile to generate API keys (live and test mode) and setup your webhook.
• Now you're ready to use the Mollie API client in test mode.
• In order to accept payments in live mode, payment methods must be activated in your account. Follow a few of steps, and let us handle the rest.

Installation

By far the easiest way to install the Mollie API client is to install it with npm.

$ npm install mollie-api-node --save

{
    "dependencies": {
        "mollie-api-node": "^1.3.5"
    }
}

You may also git checkout or download all the files, and include the Mollie API client manually.

How to receive payments

To successfully receive a payment, these steps should be implemented:

1. Use the Mollie API client to create a payment with the requested amount, description and optionally, a payment method. It is important to specify a unique redirect URL where the customer is supposed to return to after the payment is completed.

2. Immediately after the payment is completed, our platform will send an asynchronous request to the configured webhook to allow the payment details to be retrieved, so you know when exactly to start processing the customer's order.

3. The customer returns, and should be satisfied to see that the order was paid and is now being processed.

Getting started

Requiring the library.

Mollie = require("mollie-api-node");

Initializing the Mollie API client, and setting your API key.

mollie = new Mollie.API.Client;
mollie.setApiKey("test_dHar4XY7LxsDOtmnkVtjNVWXLSlXsM");

Creating a new payment.

mollie.payments.create({
    amount:      10.00,
    description: "My first API payment",
    redirectUrl: "https://webshop.example.org/order/12345/",
    webhookUrl:  "https://webshop.example.org/mollie-webhook/"
}, function (payment) {
    response.writeHead(302, { Location: payment.getPaymentUrl() })
});

Retrieving a payment.

mollie.payments.get(
    payment.id
, function (payment) {
    if (payment.isPaid()) {
        console.log("Payment received.");
    }
});

Want to help us make our API client even better?

Want to help us make our API client even better? We take pull requests, sure. But how would you like to contribute to a technology oriented organization? Mollie is hiring developers and system engineers. Check out our vacancies or get in touch.

License

BSD (Berkeley Software Distribution) License. Copyright (c) 2013-2017, Mollie B.V.

Support

Contact: www.mollie.com — [e-mail] — [phone]

• More information about iDEAL via Mollie
• More information about credit card via Mollie
• More information about Bancontact/Mister Cash via Mollie
• More information about SOFORT Banking via Mollie
• More information about SEPA Bank transfer via Mollie
• More information about SEPA Direct debit via Mollie
• More information about Bitcoin via Mollie
• More information about PayPal via Mollie
• More information about Belfius Direct Net via Mollie
• More information about paysafecard via Mollie

Changelog

v1.3.6 - 2017-08-02

• Fixed isValid() helper method of the Mandate model.