Jokul Java Library

Official NodeJs Library for Jokul API. Visit https://jokul.doku.com for more information about the product and https://jokul.doku.com/docs for the technical documentation.

Table of Contents

• Requirements
• Installation
• Usage
  • Setup Configuration
  • Virtual Account
• Example
• Help and Support

Requirements

Node v10 or above Npm v6 or above

Installation

Npm

Run command npm install jokul-nodejs-library --save && npm install sync-request --save && npm install crypto-js --save && npm install express --save && npm install body-parser

Usage

Setup Configuration

Get your Client ID and Shared Key from Jokul Back Office.

Setup your configuration:

const dokuLib = require('jokul-nodejs-library');

let setupConfiguration = dokuLib.SetupConfiguration;
    setupConfiguration.environment = 'sandbox'
    setupConfiguration.client_id = 'CLIENTID';
    setupConfiguration.merchant_name = 'MERCHANT_NAME';
    setupConfiguration.shared_key = 'SHARED_KEY';
    setupConfiguration.serverLocation = dokuLib.getServerLocation(setupConfiguration.environment);

Server Location

Sandbox: "sandbox" Production: "production"

Virtual Account

Prepare your request data:

    const dokuLib = require('jokul-nodejs-library');

    let paymentCodeRequest = dokuLib.PaymentCodeRequestDto;
        paymentCodeRequest.client.id =  setupConfiguration.client_id
        paymentCodeRequest.customer.name = 'CUSTOMER_NAME';
        paymentCodeRequest.customer.email ='EMAIL';
        paymentCodeRequest.order.invoice_number = 'INVOICE NUMBER';
        paymentCodeRequest.order.amount = 10000;
        paymentCodeRequest.virtual_account_info.info1 = 'INFO1';
        paymentCodeRequest.virtual_account_info.info2 = 'INFO2';
        paymentCodeRequest.virtual_account_info.info3 = 'INFO3';
        paymentCodeRequest.virtual_account_info.reusable_status = false;
        paymentCodeRequest.virtual_account_info.expired_time = 60;
        paymentCodeRequest.security.check_sum =dokuLib.getCheckSum(setupConfiguration, paymentCodeRequest);

Mandiri VA

After preparing your request data, you can now generate the payment code / virtual account number:

const dokuLib = require('jokul-nodejs-library');
 
dokuLib.generateMandiriVa(setupConfiguration.serverLocation, paymentCodeRequest);

Example Code - Virtual Account

Putting them all together. Here is the example code from setup your configuration to generate payment code / virtual account number:

const dokuLib = require('jokul-nodejs-library');

let setupConfiguration = dokuLib.SetupConfiguration;
    setupConfiguration.environment = 'sandbox'
    setupConfiguration.client_id = 'CLIENTID';
    setupConfiguration.merchant_name = 'MERCHANT_NAME';
    setupConfiguration.shared_key = 'SHARED_KEY';
    setupConfiguration.serverLocation = dokuLib.getServerLocation(setupConfiguration.environment);

 let paymentCodeRequest = dokuLib.PaymentCodeRequestDto;
     paymentCodeRequest.client.id =  setupConfiguration.client_id 
     paymentCodeRequest.customer.name = 'CUSTOMER_NAME';
     paymentCodeRequest.customer.email ='EMAIL';
     paymentCodeRequest.order.invoice_number = 'INVOICE NUMBER';
     paymentCodeRequest.order.amount = 10000;
     paymentCodeRequest.virtual_account_info.info1 = 'INFO1';
     paymentCodeRequest.virtual_account_info.info2 = 'INFO2';
     paymentCodeRequest.virtual_account_info.info3 = 'INFO3';
     paymentCodeRequest.virtual_account_info.reusable_status = false;
     paymentCodeRequest.virtual_account_info.expired_time = 60;
     paymentCodeRequest.security.check_sum = dokuLib.getCheckSum(setupConfiguration, paymentCodeRequest);

 dokuLib.generatePaycode(setupConfiguration.serverLocation, paymentCodeRequest);

Notification

Notification is a class for receive payment information from DOKU, so merchant can use the Dto for Serialize object and Deserialize Object Inbound Request Data :

let notifyRequestDto = dokuLib.NotifyRequestDto;
notifyRequestDto.client.id = 'CLIENT-ID';
notifyRequestDto.order.invoice_number = 'INVOICE-NUMBER';
notifyRequestDto.order.amount = 10;
notifyRequestDto.virtual_account_info.virtual_account_number = 'VANUMBER';
notifyRequestDto.virtual_account_payment.date = 'DATE';
notifyRequestDto.virtual_account_payment.systrace_number = 'SYSTRACE-NUMBER';
notifyRequestDto.virtual_account_payment.reference_number = 'REFERENCE-NUMBER';
notifyRequestDto.virtual_account_payment.channel_code = 'CHANNEL-CODE';
notifyRequestDto.security.check_sum = 'CHECKSUM';

Outbound Response Data :

let notifyResponseDto = dokuLib.NotifyResponseDto;

notifyResponseDto.client.id = 'CLIENT-ID';
notifyResponseDto.order.invoice_number = 'INVOICE-NUMBER';
notifyResponseDto.order.amount = 10;
notifyResponseDto.virtual_account_info.virtual_account_number = 'VANUMBER';
notifyResponseDto.security.check_sum = 'CHECKSUM';

Example

Please refer to this repo for the example project: Jokul Java Example.

Help and Support

Got any issues? Found a bug? Have a feature requests? You can open new issue.

For further information, you can contact us on [email protected].