Getting started with WebToken

Include the client on your page

Add the secure, hosted JavaScript client in the `<head>` of your page:

<script src="https://token.dcap.com/v1/client"></script>

Define the required form and controls

Give your payment form an ID:

<form id="payment_form">

Add the following 4 payment information input controls to your form:

<input type="text" data-token="card_number" />
<input type="text" data-token="exp_month" />
<input type="text" data-token="exp_year" />
<input type="text" data-token="cvv" />

Note: The payment info input controls must not have ID or Name attributes.

Define an input control to insert the token into:

<input type="hidden" id="token" />

Define required JavaScript

Define a JavaScript callback method for token events:

var tokenCallback = function(response) {
  if (response.Error)
  {
    alert("Token error: " + response.Error);
  }
  else
  {
    var token = response.Token;
    document.getElementById("token").value = token;
  }
}

Request a token!

Call `requestToken` with your token key, payment form ID, and token callback method:

DatacapWebToken.requestToken("[Token Key Goes Here]", "payment_form", tokenCallback);

The response object received by your callback method looks like this:

On Success

{
  Token: "DC4:AAAMbdJpMn6wZYlx84etCekz2HMpp6IQtqL0G3aMInirXYQMNLpr9oJMctxC76NVSGkO5XXO/naM0X1CfzX1md2caSTHKO4QjpYmzJlMOsQwer5VUEJWCZVzd0Ytr2jvRLw=",
  Brand: "Visa",
  ExpirationMonth: "12",
  ExpirationYear: "2020",
  Last4: "1111"
}

On Failure

{
  Error: "Failed to create token"
}

Validation Helper Methods!

The Datacap WebToken client provides a few methods to help integrators validate their input fields, for card number, expiration date, and CVV that return bool values indicating input validity.

Validate Credit Card Number

var validCard = DatacapWebToken.validateCardNumber("4242424242424242");

Validate Expiration Date

var validExpirationDate = DatacapWebToken.validateExpirationDate("06", "2020");

Validate CVV

var validCVV = DatacapWebToken.validateCVV("123");

Use your tokens!

Now that you've got fresh tokens in your payment form, you can submit the form and process token payments on Datacap's payment platform!

Report bugs

If you encounter any bugs or issues with the latest version of WebToken, please report them to us by opening a GitHub Issue!