Developer's Network
Untitled Document

TASK 1: INTEGRATE THE BUYSAFE SEAL

The buySAFE Seal is a flash/image object that is created via the WriteBuySafeSeal javascript function.  This function, as well as other internal functions of the buySAFE Seal, is included in buySAFE’s rollover.js javascript file, which will need to be inserted into your website.

The Persistent Seal is a fixed position seal anchored in the corner of the browser window.

Persistent buySAFE Seal

 

The buySAFE Seal automatically detects if Flash is enabled and, if it is, will be served as a Flash object.  If Flash is not enabled, the buySAFE Seal will be served as a static GIF image.

 

STEP 1: INSERT BUYSAFE JAVASCRIPT INTO WEBSITE

The rollover.js javascript file contains all of the javascript functions that the buySAFE Seal (and buySAFE Button, discussed in TASK 2) needs.  It is recommended that the rollover.js file is placed into your website’s header include file (if you have one) since it must be available on all pages of your website.

<script src="https://sb.buysafe.com/private/rollover/rollover.js" type="text/javascript" language="javascript" charset="utf-8"></script>

NOTE: This code points to the buySAFE SANDBOX environment which will be used during development and testing.  TASK 11 describes how to connect to the buySAFE production environment.

 

STEP 2: INSERT BUYSAFE SEAL CODE INTO WEBSITE

Next, the WriteBuySafeSeal function, with your specific Seal Hash, must be inserted into your website.

You can insert it into your website’s header include file – however, it MUST be within the <BODY> tag of your pages.  It cannot be in the <HEAD> tag.  You must specify your specific Seal Hash as the HASH parameter.  The size parameter must be present for Persistent Seals, but is ignored.
 
<span id="BuySafeSealSpan" align="center" style="text-align:center;"> <script type="text/javascript">WriteBuySafeSeal( 'BuySafeSealSpan', 'Large', 'HASH=Seal_Hash');</script> </span>

 

NOTE: When the Seal Hash is inserted into the Seal code, it must be "escaped" to properly conform to the character restrictions for URLs (as defined in RFC 1738).

 

The response time for your buySAFE Seal will be under 0.5 seconds.

 

In addition to the bottom-left Persistent Seal, buySAFE offers additional placement and size options. If you are interested in a non-standard buySAFE Seal, please contact your Integration Manager.

 

NOTES FOR SHOPPING CART PLATFORMS:

Every merchant will be given a unique Seal Hash by buySAFE (more info in SUPPLEMENTAL TASK 1). As a Shopping Cart Platform, you must keep track of each of your merchant's Seal Hashes. If a merchant has multiple stores, they will use the same Seal Hash for each of their stores.

You will be provided a Seal Hash for your development test store.

Most Shopping Cart Platforms provide their merchants with the Persistent Seal, which docks in the bottom-right corner of the browser. If you would like to discuss other options, contact your buySAFE Integration Manager.

 

 

 

<< PREVIOUS TASK || TOC || NEXT TASK >>