Skip to content

nathan818fr/hipay-professional-sdk-js

Repository files navigation

hipay-professional-sdk

npm version TypeScript Build Status codecov

HiPay Professional SDK for NodeJS. You can create orders (payment pages), capture or refund payments and securely decode Notifications (callbacks / pingbacks) sent by HiPay.

This module provides its own TypeScript declarations (.d.ts).

Installation

npm install hipay-professional-sdk

Example

const {HipayClient} = require('hipay-professional-sdk');

const hipayClient = new HipayClient({
    env: 'production',
    login: 'YOUR_API_LOGIN',
    password: 'YOUR_API_PASSWORD',
});

hipayClient
    .createOrder({
        websiteId: YOUR_WEBSITE_ID,
        categoryId: YOUR_PRODUCT_CATEGORY,
        currency: 'EUR',
        amount: '4.99',
        rating: 'ALL',
        locale: 'fr_FR',
        customerIpAddress: CUSTOMER_IP,
        description: 'Life subscription to a super service!',
        executionDate: new Date(),
        manualCapture: true,
        urlCallback: 'https://domain.tld/hipay-callback',
    })
    .then((response) => {
        if (response.error) {
            // HiPay reported an error during the request
            console.log(response.error); // {code: number, description: string}
            return;
        }

        // HiPay created the new order, you can redirect your customer to the
        // payment page!
        console.log(response.result); // {redirectUrl: string}
    })
    .catch((err) => {
        // An exception has occurred during the request (network error, ...)
    });

Usage

To begin you need to get your API credentials :

  • Login to the Hipay Professional dashboard
  • Go to the Toolbox
  • Your API credentials will be under "Access to the web service" (and are named "Login" and "Password")

You must also create a website and get it's ID:

  • On the dashboard, go to Products > Website
  • Click on "Register a new Website", complete the form and validate
  • Get your website ID (will be under your website name)

You can now start using this SDK! Usual flow is:

  1. Create an order (HipayClient.createOrder)
  2. Redirect your customer to the payment page
  3. Listen for Notifications (callbacks / pingbacks) calls (HipayClient.parseNotification)
  4. Capture payments (HipayClient.captureOrder)

Documentation

For a detailed API reference, see: hipay-professional-sdk-js.nathan818.fr

Building

This project uses TypeScript. To create javascript sources run:

yarn run build

Testing

For unit tests, a real payment flow is reproduced and tested (on the HiPay staging API):

  • An order is created
  • A browser is opened on the payment page and make a payment
  • A Notification (callback) listener wait for the transaction autorisation
  • The order is captured
  • A Notification (callback) listener wait for the transaction capture (and several other complementary tests are performed)

Run the unit tests, install the dependencies and run yarn test:

yarn install
yarn run test

Contributing

Contributions are welcome. It is recommended to open an issue before introducing new features to discuss them.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

License

This project is licensed under the Apache-2.0 License. See the LICENSE file for details.