Esta librería provee un acceso conveniente a la API REST de VentiPay para aplicaciones Node.js.
Instala la librería utilizando tu package manager favorito.
npm install @ventipay/ventipay
# o
yarn add @ventipay/ventipay
Nota: La librería requiere Node.js 12+.
La idea de esta librería es reflejar lo más posible el diseño de nuestra API para que, sólo leyendo su documentación, puedas entenderla y utilizarla de manera rápida y simple.
Por cada recurso disponible en la API encontrarás un recurso en esta librería y por cada uno de estos recursos encontrarás acciones a ejecutar sobre ellos.
El primer paso es requerir la librería y pasarle tu API Key. Puedes obtener una API Key en el Dashboard de VentiPay y recuerda que esta puede ser usada en modo live o test.
// Requiere la librería y crea el cliente de VentiPay
const ventipay = require('@ventipay/ventipay')('key_test_...'); // Provee tu API Key de modo live o test como primer parámetro del cliente
Ya puedes utilizar la librería y ejecutar acciones sobre los recursos de la API.
La librería ahora te entrega un listado de recursos de la API con sus respectivas acciones. Un recurso se ve reflejado como una propiedad del cliente recién creado y cada acción como un método asociado a esta propiedad.
// Llamando al método retrieve del recurso checkouts y pasando 2 parámetros.
const checkout = ventipay.checkouts.retrieve('chk_KaIq81HaHvaPq91c8FaK1ua6R', {
expand: ['customer'],
});
// Imprimiendo el atributo id
console.log(checkout.id);
En este ejemplo se accede al recurso checkouts y al método retrieve. El método recibe 2 parámetros: el ID del recurso a obtener y el atributo opcional expand. Finalmente, se imprime el atributo id del recurso obtenido.
Usualmente los métodos que obtienen o actualizan un recurso (create
, update
, etc.) reciben un ID como primer parámetro y opciones como segundo parámetro, en cambio los métodos que listan recursos (list
) reciben opciones como primer parámetro.
Estas opciones corresponden a los query params o body params encontrados en la documentación de la API.
Recurso | Métodos |
---|---|
checkouts |
retrieve , list , create , refund
|
payments |
retrieve , list , create , update , refund , capture
|
refunds |
retrieve , list
|
Recurso | Métodos |
---|---|
subscriptions |
retrieve , list , create , update , cancel , suspend , unsuspend
|
invoices |
retrieve , list , create , update , finalize , pay , send , markUncollectible , void
|
products |
retrieve , list , create , update
|
Recurso | Métodos |
---|---|
customers |
retrieve , list , create , update
|
Recurso | Métodos |
---|---|
payment_methods |
retrieve , list
|
setup_intents |
retrieve , create , update , del
|
Recurso | Métodos |
---|---|
events |
retrieve , list
|
Recurso | Métodos |
---|---|
balance_transactions |
retrieve , list
|
payouts |
retrieve , list
|
Los métodos provistos por la librería retornan siempre una Promesa (Promise
), por lo que puedes utilizar async/await
o then/catch
según tu preferencia.
Utilizamos SemVer para el versionamiento, por lo que puedes actualizar de manera segura cambios a nivel minor y patch.
Utilizamos la página de releases de GitHub para documentar cada release.
MIT