pagodigital-js

PagoDigital

PagoDigital es la mejor solución para todos los comercios de implementar todos los medios de pagos.

Instalación

Para instalar la librería de PagoDigital se puede hacer con npm:

npm install pagodigital-js

O también se puede utilizar yarn:

yarn add pagodigital-js

Como usar

Para comenzar a utilizar es necesario estar registrado en PagoDigital y tener uno o mas comercios habilitados y verificados.

Primeramente se debe importar y crear una instancia de PagoDigital

import PagoDigital from 'pagodigital-js';
...

const pagoDigital = new PagoDigital({
    commerceId: 120,
    token: '791a736e949d4ec57af5684679bea5d5a9f485c5'
});

Luego de instanciar PagoDigital vas a poder utilizar todas las funciones dentro de la librería

Párametro	Tipo	Descripción
commerceId	number	ID del comercio que va a utilizar la librería
token	string	Token público del comercio que utiliza la librería

Realizar un pago con plataforma especifica

Vas a poder realizar un pago a través de todas nuestras plataformas registradas.

import PagoDigital from 'pagodigital-js';
...
const pagoDigital = new PagoDigital({
    commerceId: 120,
    token: '791a736e949d4ec57af5684679bea5d5a9f485c5'
});


pagoDigital.payment.paymentWithPlatform({
    amount: 12500,
    description: "Pago de prueba con la librería",
    email: "[e-mail]",
    payerIdentification: "485987",
    payerName: "Adolf Hitler",
    phone: "0984856321",
    platform: "tigo",
    reference: "pago-22",
    location: "-27.55486,-2744157"
})
.then(paymentResponse => {
    ...
})

Párametros

Párametro	Tipo	Descripción
amount	number	Monto que se va a cobrar
description	string	Descripción del pago
email	string	Correo de la persona que esta pagando
payerIdentification	string	Identificación del usuario que está pagando (C.I)
payerName	string	Nombre del usuario que esta pagando
phone	string	Teléfono del usuario que está pagando
platform	string	Plataforma con la que se va a pagar
reference	string	Referencia de pago, generalmente es el ID del pago del comercio
location	string	Coordenadas indicando desde donde se realizó el pago (opcional)

El párametro platform es un enum que solo admite los siguientes datos:

Plataforma	Valor
Tigo	"tigo"
Personal	"personal"
Wally	"wally"
Bancard	"bancard"
Zimple	"zimple"
InfoNET	"infonet"
Pago Express	"pago express"
PayPal	"paypal"
Wepa	"wepa"
Bancard QR	"bancard qr"
Stripe	"stripe"
Transferencia bancaria	"transferencia"

En caso contrario de no enviar uno de esos párametros en el platform, va a devolver error.

Respuesta

Párametro	Tipo	Descripción
link	string	Url de redireccionamiento a donde se va a redirigir al cliente para proceder al pago
merchantTransactionId	string	ID de la transacción generado por PagoDigital

Realizar pago por link

Este proceso es similar al anterior, solo que en vez de generar para una plataforma especifica, puedes redirigir directamente a todas nuestras plataformas dentro de una página especial de PagoDigital y dejar que nosostros nos encarguemos del resto.

import PagoDigital from 'pagodigital-js';
...
const pagoDigital = new PagoDigital({
    commerceId: 120,
    token: '791a736e949d4ec57af5684679bea5d5a9f485c5'
});


pagoDigital.payment.paymentWithLink({
    amount: 12500,
    reference: "pago-22",
    description: "Pago de prueba con la librería",
    currency: 'PYG',
    suscriptionInterval: 'monthly',
})
.then(paymentResponse => {
    ...
})

Párametros

Párametro	Tipo	Descripción
amount	number	Monto que se va a cobrar
description	string	Descripción del pago
reference	string	Referencia de pago, generalmente es el ID del pago del comercio
currency	string	Moneda en la que se va a realizar el pago (USD o PYG)(Opcional: Por defecto está en PYG)
suscriptionInterval	string	Intervalo de suscripción, enviar solamente cuando quieras dar la opción de suscribirse a un pago

Respuesta

Párametro	Tipo	Descripción
link	string	Url de redireccionamiento a donde se va a redirigir al cliente para proceder al pago
merchantTransactionId	string	ID de la transacción generado por PagoDigital

Respuesta

La respuesta del pago será enviada a la URL de callback especificada en el panel de PagoDigital en el apartado de editar comercio -> desarrollo.

La respuesta será enviada en formato JSON y contiene los siguientes elementos:

key	tipo	descripción
token	string	Token generado por seguridad, es recomendable utilizarlo para validar los pagos. Se conforma de la siguiente manera: SHA256(merchant_transaction_id + amount + private_token)
merchant_transaction_id	string	Identificador de la transacción dentro de PAgoDigital
commerce_transaction_id	string	Identificador o referencia de la transacción creada por el comercio
payer_email	string	Correo electrónico de la persona que esta pagando
payer_identification	string	identificación de la paersona que esta pagando
payer_name	string	Nombre de la persona que esta pagando
phone	string	Número telefónico de la persona que esta pagando
platform	string	Plataforma con la que se esta pagando
amount	number	Monto de la transacción
fee	number	Comisión de la transacción por PagoDigital
accredited	number	Monto que se le acreditó al comercio descontando la comisión
description	string	Descripción del pago
status	string	Estado del pago (APPROVED, REFUSED, PENDING)

License

MIT