pagos24 v0.4.2

pagos24

pagos24 is the Javascript / Typescript library so you can make payments and use Pagos24 services. This library has all the necessary tools for your application to use our services.

Table of Contents

1. Installation
2. Usage
3. Login User
4. Connect User
5. Payment
6. QR Code
7. Log Out
8. Contributing

Installation

    npm install pagos24 --save

or

    yarn add pagos24

Usage

The library is initialized where the application is initialized

import { Auth, ELanguageType } from "pagos24";

Auth.init({
    token: "tokenExample",
    appId: "apiExample",
    email: "example@example.com",
    secretKey: "exampleKey",
    sandbox: true,
    projectUrl: "Project example",
    lang: ELanguageType.EnUs
})
.then((result) => ...)
.catch((err) => ...);

This function will return the currently logged user, as long as there is one, otherwise it will return undefined

Login User

To be able to use a user's data, you must first log in. This is possible with the following function:

import { Auth, ELanguageType } from "pagos24";

Auth.logIn(ELanguageType.EnUs, ELoginMode.Window)
.then((result) => ...)
.catch((err) => ...);

If you are integrating the library with a framework like Ionic, the login is different, of course, the results will be the same, it would be done in the following way:

import { AuthIonic, ELanguageType } from "pagos24";

AuthIonic.logIn('com.example://', ELanguageType.EnUs)
.then((result) => ...)
.catch((err) => ...);

The process is simple, when trying to log in, the library will search your device to see if the Pagos24 application is installed, if it is installed the application will open, otherwise it will give an error.

Like the normal login, if there is already a logged in user, it will not redirect to the other application but the data will be delivered directly.

If there is any doubt about the url scheme this link can help you to configure it Setting url schema

Connect User

To obtain the credit cards affiliated with a Pagos24 user, you must connect with him as follows:

import { Payment } from 'pagos24';

Payment.connectUser(user)
.then((resp) => ...)
.catch((err) => ...);

It is recommended to use this function just after logging in with a user

interface IUserConnect {
  avatar: string;
  email: string;
  error: number;
  fullname: string;
  lang: ELanguageType;
  qr: string;
  user_id: string;
}

Payment

There are mainly three methods to make a payment through Pagos24: With a credit card (affiliated with Pagos24), by points and by Pagos24 balance. The way to use the payment function is as follows:

import { Payment, EpaymentType, ELanguageType } from "pagos24";

Payment.payment(EpaymentType.BinCash, {
    OTPago: '012345',
    amount: 100,
    language: ELanguageType.EnUs,
    payerEmail: "example@example.com",
})
.then(result => ...)
.catch(err  => ...);

// Params interface
interface IPaymentParams {
  payerEmail: string;
  amount: number;
  OTPago: number;
  language: ELanguageType;
  creditCardNumber?: string;
}

QR Code

There is the possibility of paying through the Pagos24 mobile application by reading a QR code. With the library you can also show that code and give the possibility of paying more easily

Controller.ts:

import { Payment } from "pagos24";

Payment.generateQRCode(100)
.then((uriExample) => ...)
.catch((err) => ...);

Template.html:

<img src="uriExample" />

The function will return a base64 uri with the QR code that must be placed in the img tag within the template.

Log Out

There is a function to log out the current user

import {Auth} from 'pagos24';

function logOut() {
  Auth.logOut();
}

This function will erase the current user data

Contributing

Extraction requests are welcome. For major changes, first open a problem to discuss what you would like to change

License

MIT