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: "[email protected]",
    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