KKIAPAY NODEJS-SDK

Installing

Using npm:

    $ npm i -s kkiapay/nodejs-sdk

Initialization

Production

// setup your api key (https://www.kkiapay.me)
//initialize kkiapay in production environnment
const k = kkiapay({privatekey:"xxxxxxx",publickey:"xxxxxxx",secretkey:"xxxxxxx"})

Sandbox

//initialize kkiapay in sandbox environnment
const k = kkiapay({privatekey:"xxxxxxx",publickey:"xxxxxxx",secretkey:"xxxxxxx",sandbox:true})

Request to retrieve transactions

EXAMPLE

// Request to retrieve transactions
k.verify("transactionId").
then((response) => {
    //handle response
}).
catch((error) => {
    //handle error
})

Request to revert transaction

EXAMPLE

// Request to retrieve transactions
k.refund("transactionId").
then((response) => {
    //handle response
}).
catch((error) => {
    //handle error
})

Request to schedule payout

EXAMPLE

// Example to schedule payout when amount reaches a ceiling
k.setup_payout({algorithm : "roof", send_notification : true, destination_type : "MOBILE_MONEY", roof_amount : "1000", destination : "22997000000" }).
then((response) => {
    //handle response
}).
catch((error) => {
    //handle error
})

// Example to schedule payout by frequency
k.setup_payout({algorithm : "rate", send_notification : true, destination_type : "MOBILE_MONEY", rate_frequency : "1m", destination : "22997000000" }).
then((response) => {
    //handle response
}).
catch((error) => {
    //handle error
})

| PARAMETERS | DESCRIPTION | | ----------- | ----------------------- | | algorithm | (String) "roof" if the amount reaches a ceiling or "rate" for refund by frequency. | | send_nofitication | (Boolean) to receive a notification after payment. | | destination_type | (String) "BANK_ACCOUNT" or "MOBILE_MONEY" | | destination | (String) the bank number or phone number of the receiver of the refund | | rate_frequency | (String) "1m", "1w", "3j" Refund frequency when choosing "rate" algorithm | | roof_amount | (String) Refund amount when choosing "roof" algorithm |

COMPLETE POSSIBLE STATUS LIST

| STATUS | DESCRIPTION | | ----------- | ----------------------- | | SUCCESS | Successful transaction | | FAILED | Transaction failed | | INSUFFICIENT_FUND | Not enough money in developper account | | TRANSACTION_NOT_ELIGIBLE | This transaction are already reverted or are not eligible | | TRANSACTION_NOT_FOUND | Transaction not found | | INVALID_TRANSACTION | You are not owner of this transaction | | INVALID_TRANSACTION_TYPE | We can't revert this transaction | | INVALID_PAYOUT_DESTINATION_ACCOUNT | Provided destination account is not valid mobile money account |