0.0.5 • Published 1 month ago
@sfpy/node-core v0.0.5
Safepay Node.js Library
The Safepay Node library provides convenient access to the Safepay API from applications written in server-side JavaScript.
Requirements
Node 12 or higher.
Installation
Install the package with:
npm install @sfpy/node-core
# or
yarn add @sfpy/node-core
Usage
The package can either be configured with your account's secret key or your current JWT session token. The production secret key is available in the Safepay Dashboard, while the sandbox secret key is available in the Sandbox Safepay Dashboard. Require it with the key's value:
const safepay = require('@sfpy/node-core')('12aslkad...', {
authType: 'secret', // either 'jwt' or 'secret' depending on what you provide
host: 'https://api.getsafepay.com' // can be configured to our sandbox host for test transactions
});
safepay.customers.object.create({
"first_name": "Hassan",
"last_name": "Zaidi",
"email": "hzaidi@getsafepay.com",
"phone_number": "+923331234567",
"country": "PK",
"is_guest": false
})
.then(customer => console.log(customer.token))
.catch(error => console.error(error));
Or using ES modules and async
/await
:
import Safepay from "@sfpy/node-core";
const safepay = new Safepay("12aslkad...", {
authType: "secret", // either 'jwt' or 'secret' depending on what you provide
host: "https://api.getsafepay.com", // can be configured to our sandbox host for test transactions
});
try {
const customer = await safepay.customers.object.create({
first_name: "Hassan",
last_name: "Zaidi",
email: "hzaidi@getsafepay.com",
phone_number: "+923331234567",
country: "PK",
is_guest: false,
});
console.log(customer.token);
} catch (error) {
console.log(error);
}
Using Promises
Every method returns a chainable promise which can be used instead of a regular callback:
// Create a new customer and then create an invoice item then invoice it:
safepay.customers.object
.create({
first_name: "Hassan",
last_name: "Zaidi",
email: "hzaidi@getsafepay.com",
phone_number: "+923331234567",
country: "PK",
is_guest: false,
})
.then((customer) => {
// have access to the customer object
});
Configuration
Initialize with config object
The package can be initialized with several options:
const safepay = Safepay("sk_test_...", {
timeout: 1000,
host: "https://sandbox.api.getsafepay.com",
authType: "secret",
});
Option | Default | Description |
---|---|---|
timeout | 80000 | Maximum time each request can take in ms. |
host | 'https://api.getsafepay.com' | Host that requests are made to. |
authType | secret or jwt | Tells Safepay which authentication mechanism to use |