SWP - Checkout

What Is Checkout?

The Checkout option is the simplest method for integrating Secure Web Payments (SWP) with your website. It enables a web merchant to call Forte’s hosted payment form, allowing customers to enter and securely submit their payment information.

This method is ideal for merchants who want a fast, low-code integration that still offers flexibility and security.

Key Benefits

• Quick Setup: Minimal code required.

• Secure: Transactions are processed via Forte’s hosted form.

• Customizable: Merchants can modify the look and feel of the form using predefined styles or by passing configuration parameters dynamically.

New Guides:

• Test SWP Code
• Manage Secure Web Pay
• swp_integration.pdf

Customization Options

You can personalize the hosted payment form in two ways:

1. Predefined Styles: Choose from a list of available themes.

2. Dynamic Parameters: Use request parameters to control fields and form behavior.

Example: Use a field like billing_name=John to populate a field as read-only.
Use e_billing_name=John to make it editable by the user.

Request Parameters

SWP Checkout accepts a wide range of request parameters for transaction and user data. Prefixing a field with e_ marks it as editable; otherwise, the field is displayed as read-only on the payment form.

For a complete list of available request parameters and implementation examples, refer to the full SWP Integration Guide.

Handling UTC Time with Checkout

Checkout uses a time-sensitive security mechanism for processing requests. Each request must include a utc_time value to ensure that it is current and has not been intercepted or delayed.

✅ Time Window

• Accepted range: 20 minutes before and up to 10 minutes after the current UTC time.

• Expiration: Requests expire 10 minutes after submission.

To avoid issues caused by incorrect client-side clocks, Forte provides a getUTC API to fetch the correct time from their server.

Get UTC Time via API

Use the following endpoints to retrieve server-side UTC time:

• Production:
  https://checkout.forte.net/getUTC?callback=?

• Sandbox:
  https://sandbox.forte.net/checkout/getUTC?callback=?

Example: JavaScript Snippet

<script>
  var button = $('button[api_access_id]');
  $.getJSON('https://sandbox.forte.net/checkout/getUTC?callback=?').done(function (utc) {
    button.attr('utc_time', utc);
  });
</script>

Get UTC Time with PHP (Curl)

Here’s a sample PHP function to fetch and parse UTC ticks:

<?php
function utc() {
    $curlUTC = curl_init();
    curl_setopt($curlUTC, CURLOPT_URL, 'https://checkout.forte.net/getUTC?callback=?');
    curl_setopt($curlUTC, CURLOPT_BINARYTRANSFER, true);
    curl_setopt($curlUTC, CURLOPT_RETURNTRANSFER, true);
    $curlData = curl_exec($curlUTC);
    $positionOfOpeningParenthesis = stripos($curlData, "(");
    $positionOfClosingParenthesis = stripos($curlData, ")");
    $utc = substr($curlData, $positionOfOpeningParenthesis + 1, $positionOfClosingParenthesis - 2);
    curl_close($curlUTC);
    return $utc;
}
?>

Next Steps

• Review the full SWP Integration Guide for all available options.

• Use the sandbox environment to test your setup before going live.

• Use server-side UTC values to prevent expiration errors and ensure smooth transactions.