lemonway v1.4.0

Lemonway SDK

Usage

Create a new wallet and credit it by card

var Lemonway = require('lemonway');

var lemonway = new Lemonway(login, pass, JSONEndpoint);

lemonway.Wallet.create(ip, {
  id: id,
  email: client.mail,
  firstName: client.firstName,
  lastName: client.lastName,
  birthdate: client.birthdate
}).then(function (wallet) {
  return wallet.moneyIn(ip, {
    amount: amount,
    cardNumber: client.cardNumber,
    cardCrypto: client.cardCrypto,
    cardDate: client.cardDate,
    autoCommission: true
  });
}).then(function (transaction) {
  ...
});

Get a wallet and credit it by card using 3D Secure

var Lemonway = require('lemonway');

var lemonway = new Lemonway(login, pass, JSONEndpoint);

lemonway.Wallet.get(req, walletId)
  .then(function (wallet) {
    return wallet.moneyIn3DInit(req, {
      amount: amount,
      cardNumber: client.cardNumber,
      cardCrypto: client.cardCrypto,
      cardDate: client.cardDate,
      autoCommission: true,
      returnUrl: 'https://your-service/your-return-path'
    });
}).spread(function (acs, transaction) {
  // redirect the client to acs.actionUrl
});

List input transactions

var Lemonway = require('lemonway');

var lemonway = new Lemonway(login, pass, JSONEndpoint);

lemonway.Transaction.list(req)
  .then(function (transactions) {
    ...
  });

Upload a KYC File

var Lemonway = require('lemonway');

var lemonway = new Lemonway(login, pass, JSONEndpoint, WebkitURL);

lemonway.Wallet.get(req, walletId)
  .then(function (wallet) {
    return wallet.uploadFile(req, {
      fileName: 'RIB.png',
      type: 'RIB',
      filePath: './test/wallet/RIB.png'
    });
  });

API

Lemonway(login, pass, JSONEndpoint, webKitUrl) -> lemonway

Create a new lemonway instance

lemonway.Wallet.create(ip, opts) -> Promise<wallet>

Create a new Wallet and return a promise that resolve to the new wallet

lemonway.Wallet.update(ip, wallet, opts) -> Promise<wallet>

Update a wallet and return a promise to the updated wallet

lemonway.Wallet.get(ip, id) -> Promise<{ wallet, documents: [], ibans: [], sddMandates: [], creditCards: [] }>

Get a wallet and its attached data by id

lemonway.Wallet.list(ip, opts) -> Promise<[wallet]>

List wallet where amount changed after 'from'

lemonway.Wallet.uploadFile(ip, wallet, opts) -> Promise<document>

Upload a KYC file to Lemonway

lemonway.Wallet.listKyc(ip, opts) -> Promise<[{wallet, documents: [document], ibans: [iban], sddMandates: [sddMandate]}]>

List kyc

lemonway.Wallet.getWalletTransHistory(ip, wallet, opts) -> Promise<[transaction]>

List the wallet transaction history

lemonway.Wallet.moneyIn(ip, wallet, opts) -> Promise<transaction>

Credit a wallet via credit card WITHOUT 3D secure

lemonway.Wallet.moneyIn3DInit(ip, wallet, opts) -> Promise<{acs, transaction}>

Credit a wallet via credit card with 3D secure

lemonway.Transaction.moneyIn3DConfirm(ip, transaction, opts) -> Promise<{acs, transaction}>

Confirm a 3D secure payment process

lemonway.Transaction.moneyIn3DAuthenticate(ip, transaction) -> Promise<moneyIn>

Confirm that a transaction was done with 3D secure enabled

lemonway.Wallet.registerCard(ip, wallet, opts) -> Promise<card>

Attach a card to a wallet

lemonway.Wallet.unregisterCard(ip, wallet, card) -> Promise<card>

Detach a card from wallet

lemonway.Wallet.moneyInWithCardId(ip, wallet, card, opts) -> Promise<transaction>

Credit a wallet via a registered card

lemonway.Transaction.moneyInValidate(ip, transaction) -> Promise<transaction>

Validate a pre-auth transaction

lemonway.Wallet.registerSDDMandate(ip, wallet, opts) -> Promise<sddMandate>

Register a debit mandate

lemonway.Wallet.unregisterSDDMandate(ip, wallet, mandate) -> Promise<sddMandate>

Unregister a mandate

lemonway.Wallet.signDocumentInit(ip, wallet, mandate, opts) -> Promise<{token, redirectUrl}>

Init a document signature, return a redirectUrl to which you should redirect you client

lemonway.Wallet.moneyInSddInit(ip, wallet, mandate, opts) -> Promise<transaction>

Credit a wallet via a previously signed sdd mandate

lemonway.Wallet.moneyInChequeInit(ip, wallet, opts) -> Promise<transaction>

Pre-register a cheque, you still have to send the document to Lemonway

lemonway.Wallet.registerIBAN(ip, wallet, opts) -> Promise<iban>

Attach an iban to a wallet

lemonway.Wallet.moneyOut(ip, wallet, iban, opts) -> Promise<transaction>

Attach an iban to a wallet

lemonway.Wallet.sendPayment(ip, fromWallet, toWallet, opts) -> Promise<transaction>

P2P payment, send a payment from a wallet to another wallet

lemonway.Transaction.get(ip, id, opts) -> Promise<transaction>

Get a transaction by id

lemonway.Transaction.list(ip, opts) -> Promise<[transaction]>

lemonway.Transaction.list(ip, opts) -> Promise<[transaction]>

List input transaction

lemonway.MoneyIn.get(ip, id, opts) -> Promise<moneyIn>

lemonway.MoneyIn.get(ip, id, opts) -> Promise<moneyIn>

Get a money in

lemonway.MoneyOut.get(ip, id, opts) -> Promise<moneyOut>

lemonway.MoneyOut.get(ip, id, opts) -> Promise<moneyOut>

Get a money out

lemonway.Wallet.list(ip, opts) -> Promise<[wallet, ...]>

lemonway.Wallet.list(ip, opts) -> Promise<[wallet, ...]>

List wallets

lemonway.Wallet.registerCard(ip, wallet, opts) -> Promise<card>

lemonway.Wallet.registerCard(ip, wallet, opts) -> Promise<card>

Register and link a card to a wallet

lemonway.Wallet.unregisterCard(ip, wallet, card, opts) -> Promise<card>

lemonway.Wallet.unregisterCard(ip, wallet, card, opts) -> Promise<card>

Unregister and link a card to a wallet

lemonway.getWizypayAds(ip, opts) -> Promise<[[wizypayOffer], [wizypayAd]]>

lemonway.getWizypayAds(ip, opts) -> Promise<[[wizypayOffer], [wizypayAd]]>

Get wizypay ads

Models

Wallet

• id -> string
• lemonWayId -> string
• balance -> float
• name -> string
• email -> string
• status -> string
• blocked -> string
• method -> string
• documents -> [Document]
• ibans -> [IBAN]
• sddMandates -> [SDDMandate]
• update -> (opts) -> Promise<Wallet>
• updateStatus -> (opts) -> Promise<Wallet>
• moneyIn -> (opts) -> Promise<Transaction>
• moneyIn3DInit -> (opts) -> Promise<Transaction>
• registerCard -> (opts) -> Promise<Card>
• unregisterCard -> (card) -> Promise<Card>
• moneyInWithCardId -> (card, opts) -> Promise<Transaction>
• registerIBAN -> (opts) -> Promise<IBAN>
• registerSDDMandate -> (opts) -> Promise<mandate>
• moneyInSDDInit -> (mandate, opts) -> Promise<transaction>
• moneyInChequeInit -> (opts) -> Promise<transaction>
• moneyOut -> (iban, opts) -> Promise<transaction>
• sendPayment -> (toWallet, opts) -> Promise<transaction>
• createVCC -> (opts) -> Promise<{transaction, vcc}>
• uploadFile -> (opts) -> Promise<Document>
• listTransactions -> (opts) -> Promise<[transaction]>

ACS

• actionUrl -> string|undefined
• actionMethod -> string|undefined
• pareqFieldName -> string|undefined
• pareqFieldValue -> string|undefined
• termurlFieldName -> string|undefined
• mdFieldName -> string|undefined
• mdFieldValue -> string|undefined
• mpiResult -> string|undefined

Card

• id -> string
• is3DSecure -> boolean|undefined
• country -> string|undefined
• authorizationNumber -> string|undefined
• cardNumber -> string|undefined
• expirationDate -> string|undefined

Document

• id -> string
• status -> string|undefined
• type -> string|undefined
• validityDate -> string|undefined

IBAN

• id -> string
• status -> string|undefined
• iban -> string
• swift -> string
• holder -> string

MoneyIn

• id -> string
• O3DCode -> string|undefined

SDDMandate

• id -> string
• status -> string
• iban -> string
• swift -> string

Transaction

• id -> string
• date -> Date|undefined
• debitedWallet -> string|undefined
• creditedWallet -> string|undefined
• amountDebited -> number|undefined
• amountCredited -> number|undefined
• fee -> number|undefined
• amazonGiftCode -> string|undefined
• message -> string|undefined
• status -> string|undefined
• IBANUsed -> string|undefined
• lemonwayMessage -> string|undefined
• bankReference -> string|undefined
• virtualCreditCard -> VirtualCreditCard|undefined
• moneyIn -> MoneyIn|undefined
• card -> Card|undefined
• extra -> object|undefined
• extra.is3DSecure -> boolean|undefined
• extra.country -> string|undefined
• extra.authorizationNumber -> string|undefined
• iban -> IBAN|undefined
• getPaymentDetails -> (userInfo) -> Promise<Transaction>

VirtualCreditCard

• id -> string|undefined
• number -> string|undefined
• expirationDate -> string|undefined
• cvx -> string|undefined