Node.js library for SecurionPay API
Installation
npm install securionpay
Quick start
var api = require('securionpay')('sk_test_mysecretkey')
api.customers.create({
email: 'user@example.com',
description: 'User description'
}).then(function(customer) {
return api.cards.create(customer.id, {
number: '4242424242424242',
expMonth: '12',
expYear: '2020',
cvc: '123',
cardholderName: 'John Smith'
});
}).then(function(card) {
console.log('ID of created card object: ', card.id);
}).catch(function(e) {
// handle errors here
})
Bluebird is used as Promise library ( http://bluebirdjs.com/ ).
Preferring callbacks? All methods accept callback as their last argument. Promise is not returned when passing callback.
api.customers.create({
email: 'user@example.com',
description: 'User description'
}, function(err, customer) {
if(err) {
// handle error
} else {
// handle response
}
});
API reference
When params
is one of method arguments please refer to detailed API docs (linked) for all available fields
- charges
- customers
- cards
- subscriptions
- plans
- events
- tokens
- blacklist
- checkoutRequest
- crossSaleOffers
- customerRecords
Developing
To connect to different backend:
var api = require('securionpay')('sk_test_mysecretkey', {
url: 'http://mysecurionenv.com' // without trailing slash
});
To run unit tests and check test coverage:
npm test
npm run check-coverage
To run integration tests:
PRIVATE_KEY=sk_test_mysecretkey npm run integration-test
To run integration tests against environment other than default:
PRIVATE_KEY=sk_test_mysecretkey URL=http://mysecurionenv.com npm run integration-test
Documentation
For further information, please refer to our official documentation at https://securionpay.com/docs.