1.3.7-p-130423-0947 • Published 10 months ago

pagodigital-js v1.3.7-p-130423-0947

Weekly downloads
-
License
MIT
Repository
github
Last release
10 months ago

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árametroTipoDescripción
commerceIdnumberID del comercio que va a utilizar la librería
tokenstringToken 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: "example@gmail.com",
    payerIdentification: "485987",
    payerName: "Adolf Hitler",
    phone: "0984856321",
    platform: "tigo",
    reference: "pago-22",
    location: "-27.55486,-2744157"
})
.then(paymentResponse => {
    ...
})

Párametros

PárametroTipoDescripción
amountnumberMonto que se va a cobrar
descriptionstringDescripción del pago
emailstringCorreo de la persona que esta pagando
payerIdentificationstringIdentificación del usuario que está pagando (C.I)
payerNamestringNombre del usuario que esta pagando
phonestringTeléfono del usuario que está pagando
platformstringPlataforma con la que se va a pagar
referencestringReferencia de pago, generalmente es el ID del pago del comercio
locationstringCoordenadas indicando desde donde se realizó el pago (opcional)

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

PlataformaValor
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árametroTipoDescripción
linkstringUrl de redireccionamiento a donde se va a redirigir al cliente para proceder al pago
merchantTransactionIdstringID 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árametroTipoDescripción
amountnumberMonto que se va a cobrar
descriptionstringDescripción del pago
referencestringReferencia de pago, generalmente es el ID del pago del comercio
currencystringMoneda en la que se va a realizar el pago (USD o PYG)(Opcional: Por defecto está en PYG)
suscriptionIntervalstringIntervalo de suscripción, enviar solamente cuando quieras dar la opción de suscribirse a un pago

Respuesta

PárametroTipoDescripción
linkstringUrl de redireccionamiento a donde se va a redirigir al cliente para proceder al pago
merchantTransactionIdstringID 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:

keytipodescripción
tokenstringToken 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_idstringIdentificador de la transacción dentro de PAgoDigital
commerce_transaction_idstringIdentificador o referencia de la transacción creada por el comercio
payer_emailstringCorreo electrónico de la persona que esta pagando
payer_identificationstringidentificación de la paersona que esta pagando
payer_namestringNombre de la persona que esta pagando
phonestringNúmero telefónico de la persona que esta pagando
platformstringPlataforma con la que se esta pagando
amountnumberMonto de la transacción
feenumberComisión de la transacción por PagoDigital
accreditednumberMonto que se le acreditó al comercio descontando la comisión
descriptionstringDescripción del pago
statusstringEstado del pago (APPROVED, REFUSED, PENDING)

License

MIT