MedaPay NodeJS SDK

MedaPay Node.js Library

The MedaPay Node SDK provides convenient access to the MedaPay API from applications written in server-side JavaScript.

For complete request/response flow and types please check HTTP API Guide.


Install the package with:

npm install medapay --save
# or
yarn add medapay


The package needs to be configured with your account's bearer token, which is provided by MedaPay team. Require it and initialize with the provided token and preferred environment value:

const IS_SANDBOX = true;
const MedaPay = require('medapay').init({
bearerToken: 'eyJ......'

Bill Creation:

const SAMPLE_BILL = {
"purchaseDetails": {
"orderId": "order_12345678900ffx",
"description": "Sample good at store x",
"amount": 12.50,
"customerName": "Ayele Mekite",
"customerPhoneNumber" : "+251911000000"
"redirectUrls": {
"returnUrl": "",
"cancelUrl": "",
"callbackUrl": ""
.then(createBillResponse => console.log(createBillResponse.billReferenceNumber))
.catch(error => console.error(error));

Bill Status Check:

.then(bill => console.log(bill.status))
.catch(error => console.error(error));