Skip to content

acidtango/arcus-js

Repository files navigation

arcus-js

NPM version CI

Arcus TypeScript client library for Arcus API v3.x

Installation

npm install --save @acid-tango/arcus-js
# or
yarn add @acid-tango/arcus-js

Usage

Authentication

import { Arcus } from '@acid-tango/arcus-js';

const arcusClient = Arcus.create(
    process.env.ARCUS_API_KEY as string,
    process.env.ARCUS_SECRET_KEY as string,
  );

Get account info

Returns all the info about your account.

const account = await arcusClient.getAccount()

Billers methods

Return all billers:

const allBillers = await arcusClient.getBillers()

Return billers by type:

const utilities = await arcusClient.getBillersUtilities()
const topUps = await arcusClient.getBillersTopUps()
const giftCards = await arcusClient.getBillersGiftCards()

Payment

// Creates a single payment and returns the created transaction
const singlePayParams: ArcusSinglePayParams = {...}

const transaction = await arcusClient.singlePay(singlePayParams)

Transactions

Get a transaction by id:

const transaction = await arcusClient.getTransaction(transactionId)

Cancel a transaction by id:

await arcusClient.cancelTransaction(transactionId)

How to do a release

  1. Update the changelog
    yarn release
    
  2. Delete the tag created by the release script
  3. Create a PR
  4. Merge to main with rebase and merge button to avoid merge commit.
  5. Create a tag starting with "v". example v0.0.6
  6. Push the tag
  7. Create a release
  8. Wait for ci to automatically publish.

Contributing

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'feat: Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request :D

📲 Contact

The project was mainly developed by Abel García, Aarón Pérez, Daniel Ramos and Daniel Gak from Acid Tango with ❤️ and 💪 for Rabbit.

License

MIT