Payment Request FormΒΆ

The first step in integrating with the FloCash gateway is to create a payment form in thecheckout page. A payment form collects order information from the customer and invokes the FloCash Express Checkout page.In addition to order data, the customer designates the method of payment with which he or she wishes to pay. The order information can include a billing address and a shipping address. The customers card or mobile wallet details needs to be sentin the authorization request the payment page provides a form for the customer to enter these details securely. Further details on correctly formatting and sending the authorization request are shown in the API section of this manual.

The information collected from the form should include additional hidden elements set by the merchant. The submit action of this form sends data to the FloCash payment gateway, where a payment page is dynamically created for the customer.

An example of this form is as follows:


No. Field Name Description Note
1 amount The total amount the buyer needs to pay Total amount to pay
2 currency_code 3-letter code of the currency of the amount based on ISO 4217 Currency for the transaction
3 custom Customer Id This is a custom field that the merchant can pass to the FloCash gateway
4 item_name

Item description which will be displayed to

buyer atcheck out

  
5 item_price Price per item  
6 merchant

Merchant email(which was registered at

FloCash)

 This field is used by FloCash gateway to identify the merchant.
7 order_id Order Id Used for managing orders
8 quantity The number of items  
9 notify_url

The url that FloCash should send notifica

tion to

 This parameter is optional can also be set under merchant profile
10 Cancel_url The url that FloCash should redirect user if payment is cancelled by buyer This parameter is optional canalso be set under merchant profile
11 Custom The url that FloCash should edirect user if payment is successfully completed This parameter is optional can also be set under merchant profile

Example HTML code:


<form action="http://sandbox.flocash.com/ecom/ecommerce.do" method="post">
  <!--Merchant account--> <input type="hidden" name="merchant" value="your_email@domain.com"/>
  <!--Order Id-->
  <input type="hidden" name="order_id" value="<?php echo rand(100000, 999999);?>"/>
  <!--Customer Id-->
  <input type="hidden" name="custom" value="<?php echo rand(100000, 999999);?>"/>
  <!--Currency Code-->
  <input type="hidden" name="currency_code" value="USD"/>
  <table width="100%" border="0" cellspacing="0" cellpadding="5">
        <col width="150" align="right">
        <col align="left">
        <!--Item Name-->
        <tr>
          <td>Item</td>
          <td>
                <input type="text" id="item_name" name="item_name" readonly="true" value="Merchant Credit"/>
          </td>
        </tr>
        <tr>
          <td>Price</td>
          <td>
                <select id="item_price" name="item_price" style="width: 100px" onchange="javascript:calculate();">
                  <option value="0.1">0.1</option>
                  <option value="0.2">0.2</option>
                  <option value="0.5">0.5</option>
                  <option value="1">1</option>
                  <option value="2">2</option>
                  <option value="5">5</option>
                  <option value="10">10</option>
                  <option value="20">20</option>
                  <option value="50">50</option>
                  <option value="100">100</option>
                </select>
        </tr>
        <tr>
          <td>Quantity</td>
          <td>
                <select id="quantity" name="quantity" style="width: 100px" onchange="javascript:calculate();">
                  <option value="1">1</option>
                  <option value="2">2</option>
                  <option value="3">3</option>
                  <option value="4">4</option>
                  <option value="5">5</option>
                  <option value="6">6</option>
                  <option value="7">7</option>
                  <option value="8">8</option>
                  <option value="9">9</option>
                  <option value="10">10</option>
                </select>
          </td>
        </tr>
        <tr>
          <td>Amount</td>
          <td><input id="amount" name="amount" style="width: 100px" readonly="true">&nbsp;USD</td>
        </tr>
        <tr>
          <td>&nbsp;</td>
          <td><input type="submit" value="Checkout"></td>
        </tr>
  </table>
</form>

JavaScript for calculating total amount automatically using item price and quantity:

<script type="text/javascript">
  function calculate() {
    var amount = document.getElementById('amount');
    varitemPrice = document.getElementById('item_price');
    var quantity = document.getElementById('quantity');
    amount.value = itemPrice.value * quantity.value;
  }

  // calculate on page load
  calculate();
</script>