Ewallets endpoints

README.md

@@ -5,6 +5,28 @@ This library is the abstraction of Xendit API for access from applications writt
 **Note**: This library is only meant for usage from server-side with Xendit secret API key.
 For PCI compliance to be maintained, tokenization of credt cards info should be done on client side with [Xendit.js](https://docs.xendit.co/xenpayments/payments-credit-cards-overview/credit-cards-integration-and-testing/collecting-card-details-tokenization/index.html).
 
+<!-- toc depthFrom:2 -->
+
+- [API Documentation](#api-documentation)
+- [Installation](#installation)
+- [Usage](#usage)
+  * [Card Services](#card-services)
+    + [Methods](#methods)
+  * [Virtual Account Services](#virtual-account-services)
+    + [Methods](#methods-1)
+  * [Disbursement Services](#disbursement-services)
+    + [Methods](#methods-2)
+  * [Invoice Services](#invoice-services)
+    + [Methods](#methods-3)
+  * [EWallet Services](#ewallet-services)
+    + [OVO](#ovo)
+      - [Methods](#methods-4)
+    + [Dana](#dana)
+      - [Methods](#methods-5)
+    + [LinkAja](#linkaja)
+      - [Methods](#methods-6)
+- [Contributing](#contributing)
+
 <!-- toc -->
 
 - [API Documentation](#api-documentation)
@@ -18,6 +40,13 @@ For PCI compliance to be maintained, tokenization of credt cards info should be
     + [Methods](#methods-2)
   * [Invoice Services](#invoice-services)
     + [Methods](#methods-3)
+  * [EWallet Services](#ewallet-services)
+    + [OVO](#ovo)
+    + [Methods](#methods-4)
+    + [Dana](#dana)
+    + [Methods](#methods-5)
+    + [LinkAja](#linkaja)
+    + [Methods](#methods-6)
 - [Contributing](#contributing)
 
 <!-- tocstop -->
@@ -399,6 +428,120 @@ i.getAllInvoices(data?: {
   })
 ```
 
+### EWallet Services
+
+Instanitiate Invoice service using constructor that has been injected with Xendit keys
+
+```js
+const { EWallet } = x;
+const ewalletSpecificOptions = {};
+const ew = new EWallet(ewalletSpecificOptions);
+```
+
+- #### OVO
+
+  Example: Create an OVO payment
+
+```js
+ew.ovo.createPayment({
+    externalID: 'my-ovo-payment',
+    amount: 1,
+    phone: '081234567890',
+  })
+  .then(r => {
+    console.log('create OVO payment detail:', r);
+    return r;
+  })
+```
+
+  #### Methods
+
+  - Create an OVO payment
+```ts
+ew.ovo.createPayment(data: {
+  externalID: string;
+  amount: number;
+  phone: string;
+})
+```
+
+  - Get an OVO Payment Status
+```ts
+ew.ovo.getPaymentStatusByExtID(data: { externalID: string })
+```
+
+- #### Dana
+
+  Example: Create a dana payment
+
+```js
+ew.dana.createPayment({
+    externalID: 'my-dana-payment',
+    amount: 1,
+    callbackURL: 'https://my-shop.com/callbacks',
+    redirectURL: 'https://my-shop.com/home',
+  })
+  .then(r => {
+    console.log('create Dana payment detail:', r);
+    return r;
+  })
+```
+
+  #### Methods
+
+  - Create an Dana payment
+```ts
+ew.dana.createPayment(data: {
+  externalID: string;
+  amount: number;
+  expirationDate?: string;
+  callbackURL: string;
+  redirectURL: string;
+})
+```
+
+- #### LinkAja
+
+  Example: Create a linkAja payment
+
+```js
+ew.linkaja.createPayment({
+    externalID: 'my-linkaja-payment',
+    phone: '081234567890',
+    amount: 30000,
+    items: [
+      {
+        id: '123123',
+        name: 'Phone Case',
+        price: 100000,
+        quantity: 1,
+      },
+      {
+        id: '345678',
+        name: 'Powerbank',
+        price: 200000,
+        quantity: 1,
+      },
+    ],
+    callbackURL: 'https://yourwebsite.com/callback',
+    redirectURL: 'https://yourwebsite.com/home',
+  })
+```
+
+  #### Methods
+
+  - Create an Dana payment
+```ts
+ew.linkaja.createPayment(data: {
+  externalID: string;
+  phone: string;
+  amount: number;
+  items: paymentItem[];
+  callbackURL: string;
+  redirectURL: string;
+})
+```
+
 ## Contributing
 
 Running test suite

examples/ewallet.js

@@ -0,0 +1,80 @@
+const x = require('./xendit');
+
+const EWallet = x.EWallet;
+const ew = new EWallet({});
+
+ew.ovo
+  .createPayment({
+    externalID: new Date(),
+    amount: 1,
+    phone: '081234567890',
+  })
+  .then(r => {
+    console.log('create OVO payment detail:', r); // eslint-disable-line no-console
+    return r;
+  })
+  .then(({ external_id }) =>
+    ew.ovo.getPaymentStatusByExtID({ externalID: external_id }),
+  )
+  .then(r => {
+    console.log('OVO payment status detail:', r); // eslint-disable-line no-console
+    return r;
+  })
+  .catch(e => {
+    console.error(e); // eslint-disable-line no-console
+    process.exit(1);
+  });
+
+ew.dana
+  .createPayment({
+    externalID: new Date(),
+    amount: 1,
+    callbackURL: 'https://my-shop.com/callbacks',
+    redirectURL: 'https://my-shop.com/home',
+  })
+  .then(r => {
+    console.log('create dana payment detail:', r); // eslint-disable-line no-console
+    return r;
+  })
+  .then(({ external_id }) =>
+    ew.dana.getPaymentStatusByExtID({ externalID: external_id }),
+  )
+  .then(r => {
+    console.log('Dana payment status detail:', r); // eslint-disable-line no-console
+    return r;
+  })
+  .catch(e => {
+    console.error(e); // eslint-disable-line no-console
+    process.exit(1);
+  });
+
+ew.linkaja
+  .createPayment({
+    externalID: new Date(),
+    phone: '081234567890',
+    amount: 30000,
+    items: [
+      {
+        id: '123123',
+        name: 'Phone Case',
+        price: 100000,
+        quantity: 1,
+      },
+      {
+        id: '345678',
+        name: 'Powerbank',
+        price: 200000,
+        quantity: 1,
+      },
+    ],
+    callbackURL: 'https://yourwebsite.com/callback',
+    redirectURL: 'https://yourwebsite.com/home',
+  })
+  .then(r => {
+    console.log('create linkAja payment detail:', r); // eslint-disable-line no-console
+    return r;
+  })
+  .catch(e => {
+    console.error(e); // eslint-disable-line no-console
+    process.exit(1);
+  });

integration_test/ewallet.test.js

@@ -0,0 +1,17 @@
+const x = require('./xendit.test');
+
+const { EWallet } = x;
+const e = new EWallet({});
+
+module.exports = function() {
+  return e
+    .createOVOPayment({
+      externalID: Date.now().toString(),
+      phone: '081234567890',
+      amount: 100000,
+    })
+    .then(() => {
+      // eslint-disable-next-line no-console
+      console.log('Invoice integration test done...');
+    });
+};

src/ewallet/dana.d.ts

@@ -0,0 +1,17 @@
+import { EWalletOptions } from './ewallet_opts';
+
+export = class OVO {
+  constructor({});
+  static _constructorWithInjectedEWalletOpts: (
+    opts: EWalletOptions,
+  ) => typeof OVO;
+  createPayment(data: {
+    externalID: string;
+    amount: number;
+    expirationDate?: string;
+    callbackURL: string;
+    redirectURL: string;  
+  }): Promise<object>;
+  getPaymentStatusByExtID(data: { externalID: string }): Promise<object>;
+};
+

src/ewallet/dana.js

@@ -0,0 +1,67 @@
+const { Validate, Auth, fetchWithHTTPErr, promWithJsErr } = require('../utils');
+
+const DANA_EWALLET_PATH = '';
+
+function Dana(options) {
+  let aggOpts = options;
+  if (Dana._injectedOpts && Object.keys(Dana._injectedOpts).length > 0) {
+    aggOpts = Object.assign({}, options, Dana._injectedOpts);
+  }
+
+  this.opts = aggOpts;
+  this.API_ENDPOINT = this.opts.eWalletURL + DANA_EWALLET_PATH;
+  this.EWALLET_TYPE = 'DANA';
+}
+
+Dana._injectedOpts = {};
+Dana._constructorWithInjectedEWalletOpts = function(options) {
+  Dana._injectedOpts = options;
+  return Dana;
+};
+
+Dana.prototype.createPayment = function(data) {
+  return promWithJsErr((resolve, reject) => {
+    Validate.rejectOnMissingFields(
+      ['externalID', 'amount', 'callbackURL', 'redirectURL'],
+      data,
+      reject,
+    );
+
+    fetchWithHTTPErr(`${this.API_ENDPOINT}`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        Authorization: Auth.basicAuthHeader(this.opts.secretKey),
+      },
+      body: JSON.stringify({
+        external_id: data.externalID,
+        amount: data.amount,
+        expiration_date: data.expirationDate,
+        callback_url: data.callbackURL,
+        redirect_url: data.redirectURL,
+        ewallet_type: this.EWALLET_TYPE,
+      }),
+    })
+      .then(resolve)
+      .catch(reject);
+  });
+};
+
+Dana.prototype.getPaymentStatusByExtID = function(data) {
+  return promWithJsErr((resolve, reject) => {
+    Validate.rejectOnMissingFields(['externalID'], data, reject);
+    fetchWithHTTPErr(
+      `${this.API_ENDPOINT}?external_id=${data.externalID}&ewallet_type=${this.EWALLET_TYPE}`,
+      {
+        method: 'GET',
+        headers: {
+          Authorization: Auth.basicAuthHeader(this.opts.secretKey),
+        },
+      },
+    )
+      .then(resolve)
+      .catch(reject);
+  });
+};
+
+module.exports = Dana;

src/ewallet/ewallet.d.ts

@@ -0,0 +1,16 @@
+import ovo  from './ovo';
+import dana from './dana';
+import linkaja from './linkaja';
+import { XenditOptions } from '../xendit_opts';
+
+export = class EWallet {
+  constructor({});
+  static _constructorWithInjectedXenditOpts: (
+    opts: XenditOptions,
+  ) => typeof EWallet;
+
+  ovo: typeof ovo;
+  createDanaPayment = dana.createPayment;
+  getDanaPaymentStatusByExtID = dana.getByExtID;
+  createLinkAjaPayment = linkaja.createPayment;
+};

src/ewallet/ewallet.js

@@ -0,0 +1,31 @@
+const OVO = require('./ovo');
+const Dana = require('./dana');
+const LinkAja = require('./linkaja');
+
+const EWALLET_PATH = '/ewallets';
+
+function EWallet(options) {
+  let aggOpts = options;
+  if (EWallet._injectedOpts && Object.keys(EWallet._injectedOpts).length > 0) {
+    aggOpts = Object.assign({}, options, EWallet._injectedOpts);
+  }
+
+  this.opts = aggOpts;
+  this.opts.eWalletURL = this.opts.xenditURL + EWALLET_PATH;
+
+  let ovo = OVO._constructorWithInjectedEWalletOpts(this.opts);
+  let dana = Dana._constructorWithInjectedEWalletOpts(this.opts);
+  let linkaja = LinkAja._constructorWithInjectedEWalletOpts(this.opts);
+
+  this.ovo = new ovo({});
+  this.dana = new dana({});
+  this.linkaja = new linkaja({});
+}
+
+EWallet._injectedOpts = {};
+EWallet._constructorWithInjectedXenditOpts = function(options) {
+  EWallet._injectedOpts = options;
+  return EWallet;
+};
+
+module.exports = EWallet;