Tokenize

What is Runner.js?

Runner.js is a browser-side JavaScript library used to tokenize and send sensitive payment information directly from a user’s browser, keeping your customers’ data secure and your software fully PCI-compliant. A single integration to Runner.js can be used to handle tokenization for all supported Payments API products in Run Developer.

Requirements:

Before you can tokenize an account using Runner.js, you must have:

• public_key generated in Run Merchant or provided by your Integration Delivery Lead.

Usage

1. Add the Runner.js script to your page by adding the tag to the header of your HTML file. version number is required as indicated in the slug below. Use latest for the most recent release.

1
<script src=”https://javelin.runpayments.io/javascripts/<version>/runner.js”></script>

For example, if you are using version 1.1.4:

1
<script src=”https://javelin.runpayments.io/javascripts/1.1.4/runner.js”></script>

Or you can use the latest value for version to always use the latest release:

1
<script src=”https://javelin.runpayments.io/javascripts/latest/runner.js”></script>

2. Initialize Runner.js using your public_key.

1
var runner = new Runner();
2
  runner.init({
3
    element: '#run-form',
4
    publicKey: '<YOUR KEY>',
5
    css: 'input%7Bwidth%3A200px%3B%7D',
6
    tokenizeAutomatically: true,
7
    inactivityto: 200,
8
    useExpiry: true,
9
    useCvv: true,
10
    cardLabel: 'Your Test Card Label',
11
    cvvLabel: 'Your Test CVV Label',
12
    expiryLabel: 'Your Test Expiry Label'
13
  });

3. (Optional) Subscribe to iframe loaded event:

1
runner.onLoaded(function() {
2
      console.log('loaded');
3
  });

4. Call the tokenize method to generate tokenized account information that has been entered into the Runner.js field. The resulting value may then be passed to the Payment API to enact payment processing activities. (Note: This action can be completed during form submission, if preferred.)

1
runner.tokenize(res);

The function within the tokenize call will return the following data: