1.0.0 • Published 3 years ago

kkiapay-nodejs-sdk v1.0.0

Weekly downloads
-
License
ISC
Repository
-
Last release
3 years ago

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
})
PARAMETERSDESCRIPTION
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

STATUSDESCRIPTION
SUCCESSSuccessful transaction
FAILEDTransaction failed
INSUFFICIENT_FUNDNot enough money in developper account
TRANSACTION_NOT_ELIGIBLEThis transaction are already reverted or are not eligible
TRANSACTION_NOT_FOUNDTransaction not found
INVALID_TRANSACTIONYou are not owner of this transaction
INVALID_TRANSACTION_TYPEWe can't revert this transaction
INVALID_PAYOUT_DESTINATION_ACCOUNTProvided destination account is not valid mobile money account