Payment iFrame

If you want to have full flexibility for the screen design of your checkout pages but want to avoid handling sensitive payment information such as credit card numbers, you can use a hosted form for the required input fields and insert that form in an iFrame on your website. The data that your customer enters to that form will be directly sent to our Gateway.


Required Fields

In addition to the fields that are mandatory for every payment request that you initiate through a HTML form, the following fields are required for the iFrame integration:

Field    Comment
checkoutoption   For the iFrame integration, set the value for this parameter to simpleform 

Provide the URI where the Gateway can send back the message with Windows.postMessage() API available in HTML 5 enabled browsers, e.g.


Optional Fields

Field    Comment
paymentMethod   For this type of integration, we recommend you let your customers choose the payment method on your page and submit the payment method in the request. See valid values for this parameter here.

This field allows you to customize the colors of buttons within the iFrame. If you e.g. send the value #9c22ce, the color of buttons will be violet.

> See further option fields for the HTML form
> See how to tokenize the entered card details for future use


iFrame Size

  • Minimum height 900px
  • Minimum width 406px


Sample Code for the HTML Form

<form method="post" action="">
 <input type="hidden" name="checkoutoption“ value=“simpleform“>
 <input type="hidden" name="hostURI“ value=““>
 <input type="hidden" name="txntype" value="preauth">
 <input type="hidden" name="paymentMethod" value="M">
 <input type="hidden" name="timezone" value="Europe/Berlin"/>
   <input type="hidden" name="txndatetime" value="<?php echo getDateTime() ?>">
   <input type="hidden" name="hash_algorithm" value="SHA256"/>
   <input type="hidden" name="hash" value="<?php echo createHash( "13.00","978" ) ?>">
 <input type="hidden" name="storename" value="10123456789">
 <input type="hidden" name="chargetotal" value="13.00">
 <input type="hidden" name="currency" value="978">
 <input type="submit" value="Submit">


    JSP Example

    <div id="embeddableConnect"> 
    <table border="0" cellpadding="0" cellspacing="0" width="100%"> 
    <iframe name="myFrame" id="myFrame" src="#" width="460px" height="900px" style="border: none;">
    Your browser does not support inline frames. 


    JavaScript Changes

    You need to register a method e.g. 'receiveMessage' with the listener like

    window.addEventListener("message", receiveMessage, false);
    function receiveMessage(event)
      var connectForm = event.source.document.forms[0];
    function forwardForm(redirectURL, connectForm) {
                        var newForm = document.createElement("form");
                        for(j=0 ; j<connectForm.elements.length; j++){
                                             var element = connectForm.elements[j];
                                             var input = document.createElement("input");
                                             input.setAttribute("type", "hidden");
                                             input.setAttribute("value", element.value);


    Browser Support

    This integration option requires HTML5 enabled browsers (all modern browsers incl. Google Chrome, Chromium, Firefox, Opera, Microsoft Edge and Apple Safari).