Some content on this site may not be available right now. We are aware and actively monitoring the situation.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Basic Implementation for 2Pay.js Payments Solution

Set up the 2Pay.js drop-in payments client to accept payments on your website.

Collecting payments consists of creating a payment form, tokenizing sensitive card information, and using that token to create a charge.

Use case

1

Create the payment form

Create a payment form with id="payment-form":

<form type="post" id="payment-form">
  <div class="form-group">
    <label for="name" class="label control-label">Name</label>
    <input type="text" id="name" class="field form-control">
  </div>
  <button class="btn btn-primary" type="submit">Generate token</button>
</form>
2

Add the card element

Inside the form add an element with id="card-element". The form should now look like this:

<form type="post" id="payment-form">
  <div class="form-group">
    <label for="name" class="label control-label">Name</label>
    <input type="text" id="name" class="field form-control">
  </div>

  <div id="card-element">
    <!-- A TCO IFRAME will be inserted here. -->
  </div>

  <button class="btn btn-primary" type="submit">Generate token</button>
</form>
3

Include the 2Pay.js library

Include the 2Pay.js drop-in payment client JavaScript:

<script type="text/javascript" src="https://2pay-js.2checkout.com/v1/2pay.js"></script>
4

Add configuration JavaScript to create the card component and generate a token

Insert the following configuration JavaScript to add the card component and generate a token request:

window.addEventListener('load', function() {
  // Initialize the JS Payments SDK client.
  let jsPaymentClient = new  TwoPayClient('YOUR_MERCHANT_CODE');
  
  // Create the component that will hold the card fields.
  let component = jsPaymentClient.components.create('card');
  
  // Mount the card fields component in the desired HTML tag. This is where the iframe will be located.
  component.mount('#card-element');
  
  // Optionally track the time that it took for the user to enter their name
  let nameFieldStartTime = null;
  let holderNameTime = 0;

  const nameField = document.querySelector('#name');

  nameField.addEventListener('focus', function () {
    nameFieldStartTime = new Date().getTime();
  });

  nameField.addEventListener('blur', function () {
    if (nameFieldStartTime) {
      const endTime = new Date().getTime();
      holderNameTime = ((endTime - nameFieldStartTime) / 1000).toFixed(2);
    }
  });

  // Handle form submission.
  document.getElementById('payment-form').addEventListener('submit', (event) => {
    event.preventDefault();
    
    // Extract the Name field value
    const billingDetails = {
      billing: {
      	name: document.querySelector('#name').value,
      	holderNameTime: holderNameTime || 0
      },
      scope: 'subscription' // accepted values: subscription, ordering
    };

    // Call the generate method using the component as the first parameter
    // and the billing details as the second one
    jsPaymentClient.tokens.generate(component, billingDetails).then((response) => {
      console.log(response); // {token: '9578f608-e96e-4667-be68-0ab42d4fd7f4', cardBrand: 'visa'}
      const token = response.token; //use it to place your order
      const cardBrand = response.cardBrand;  // informative data, you may use is anyway you want
    }).catch((error) => {
      console.error(error);
    });
  });
});
5

Place the order using the generated token

Follow this article to place orders via API using a 2Pay.js token.

Demo

After performing the steps above, your implementation should look like this.

HTML

JavaScript

Last updated

Was this helpful?