Shift4 Node.js Library

Installation

npm install shift4

Quick start

const api = require('shift4')('sk_test_my_secret_key');
(async () => {
  try {
    const customer = await api.customers.create({
      email: 'user@example.com',
      description: 'User description'
    })
    console.log('ID of created customer object: ', customer.id);

    const card = await api.cards.create(customer.id, {
      number: '4242424242424242',
      expMonth: '12',
      expYear: '2025',
      cvc: '123',
      cardholderName: 'John Smith'
    })
    console.log('ID of created card object: ', card.id);

    const charge = await api.charges.create({
      amount: 1000,
      currency: "EUR",
      card: card.id,
      customerId: customer.id
    });
    console.log('ID of created charge object: ', charge.id);
  } catch (e) {
    console.error(e)
    // handle errors
  }
})();

API reference

Please refer to detailed API docs (linked) for all available fields

• charges
  • create(params)
  • get(chargeId)
  • update(chargeId, params)
  • capture(chargeId)
  • refund(chargeId, [params])
  • list([params])
• customers
  • create(params)
  • get(customerId)
  • update(customerId, params)
  • delete(customerId)
  • list([params])
• cards
  • create(customerId, params)
  • get(customerId, cardId)
  • update(customerId, cardId, params)
  • delete(customerId, cardId)
  • list(customerId, [params])
• subscriptions
  • create(params)
  • get(subscriptionId)
  • update(subscriptionId, params)
  • cancel(subscriptionId, [params])
  • list([params])
• plans
  • create(params)
  • get(planId)
  • update(planId, params)
  • delete(planId)
  • list([params])
• events
  • get(eventId)
  • list([params])
• tokens
  • create(params)
  • get(tokenId)
• blacklist
  • create(params)
  • get(blacklistRuleId)
  • delete(blacklistRuleId)
  • list([params])
• checkoutRequest
  • sign(checkoutRequestObjectOrJson)
• credits
  • create(params)
  • get(creditId)
  • update(creditId, params)
  • list([params])
• disputes
  • get(disputeId)
  • update(disputeId, params)
  • close(disputeId)
  • list([params])
• fileUploads
  • upload(content, params)
  • get(fileUploadId)
  • list([params])
• fraudWarnings
  • get(fraudWarningId)
  • list([params])
• paymentMethods
  • create(params)
  • retrieve(payment_method_id)
  • delete(payment_method_id)
  • list([params])

For further information, please refer to our official documentation at https://dev.shift4.com/docs

Developing

To connect to different backend:

var api = require('shift4')({
  secretKey: 'sk_test_my_secret_key',
  apiUrl: 'https://api.myshift4env.com',
  uploadsUrl: 'https://uploads.myshift4env.com'
});

To run tests:

SECRET_KEY=sk_test_my_secret_key npm run test

To run style check:

npm run stylecheck