Novelty Palliates Malaise

    hipay-professional-sdk
    TypeScript icon, indicating that this package has built-in type declarations

    1.2.0 • Public • Published

    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.

    Keywords

    Install

    npm i hipay-professional-sdk

    DownloadsWeekly Downloads

    17

    Version

    1.2.0

    License

    Apache-2.0

    Unpacked Size

    80.1 kB

    Total Files

    17

    Last publish

    Collaborators

    • nathan818