HTML Form Integration

Input parameters

No. Field Name Description Required Data type Example
1 merchant_name Merchant name Yes 1-100 characters Demo Shop
2 Merchant Merchant username Yes 1-50 Characters
3 Custom Merchant defined feild Yes 1-25 characters C0000001
4 order_id Unique transaction ID if the order Yes 1-25 characters AT000001
5 Amount The total amount the buyer needs to pay Yes Float 23.45
6 item_name Name of Item Yes 1-250 characters Call Credit
7 item_price Price per item Yes float 2.50
8 currency_code 3 letter code of the currency of the amountbased on ISO 4217 Yes 3 Characters USD
9 Quantity The number of items Yes int 1
10 mage_url Merchants logo image to show during payment. No 1-250 Characters
11 return_url The return URL is where buyers will automatically redirected to or invited to go to by clicking a link afte rsuccessful payment. No 1-250 characters  
12 cancel_url The cancel URL is the page to which FloCash redirects buyers browser if the buyer does not approve the payment. No 1-250 character  
13 flo_user_XYZ
Custom parameters. Merchant can add any extra parameter starting with flo_user. For example:

flo_user_cabin, flo_user_origincount ry...

No 1-250 character  
14 Country 2-letter country co de ISO 3166-1 alph a-2 No 2 characters KE
15 user_firstName First name of customer No 1-250 characters John
16 user_lastName

Last name of


No 1-250 characters Smith
17 user_address Customer Address No 1-250 characters  
18 user_city City of Customer No 1-250 characters  
19 user_state State of Customer No 2 characters  
20 user_postalCode Postal code of customer No 1-250 characte rs  
21 user_email Customer e-mail No 1-250 characte rs  
22 user_mobile Customer mobile number No 1-250 character  

Example of html form

        <form action="" method="post">
          <input type="hidden" name="cancel_url" value="">
          <input type="hidden" name="notify_url" value="">
          <input type="hidden" name="return_url" value="">
          <table width="100%" border="0" cellspacing="0" cellpadding="5">
                  <td>Merchant Account</td>
                  <td><input name="merchant" size="50" value=""></td>
                  <td>Merchant Name</td>
                  <td><input name="merchant_name" size="50" value="John"></td>
                  <td>Order Id</td>
                  <td><input name="order_id" size="50" value="12345678"></td>
                  <td>Customer Id</td>
                  <td><input name="custom" size="50" value="1234567890"></td>
                  <td>Item name</td>
                  <td><input name="item_name" size="50" value="Merchant Credit"></td>
                  <td>Item price</td>
                  <td><input name="item_price" size="50" value="1"></td>
                  <td><input name="currency_code" size="50" value="USD"></td>
                  <td><input name="quantity" size="50" value="10"></td>
                  <td><input name="amount" size="50" value="10"></td>
                  <td>Customer Account</td>
                  <td><input name="customer_acc" size="50" value=""></td>
                  <td colspan="2">Customer Information:</td>
                  <td><input type="text" name="country" value="KE"></td>
                  <td>First Name</td>
                  <td><input type="text" name="user_firstName" value="Tom"></td>
                  <td>Last name</td>
                  <td><input type="text" name="user_lastName" value="Cruise"></td>
                  <td><input type="text" name="user_address" value="address"></td>
                  <td><input type="text" name="user_city" value="city"></td>
                  <td><input type="text" name="user_state" value="user State"></td>
                  <td>Postal Code</td>
                  <td><input type="text" name="user_postalCode" value="postal Code"></td>
                  <td><input type="text" name="user_email" value="email"></td>
                  <td><input type="text" name="user_mobile" value="mobile"></td>
                  <td colspan="2"><input type="submit" value="Pay!"></td>

Output parameters

No. Field Name Description Data type sample
1 merchant Merchant username 1-50 Characters
2 sender_acct Sender Account 1-50 Characters



3 order_id Unique transaction ID of the order 1-25 Characters AT000001
4 Amount The total amount the buyer needs to pay float 23.45
5 item_name Name of Item 1-250 Characters Call Credit
6 item_price Price per item float 2.50
7 currency_code 3-letter code of the currency of the ammo unt based on ISO4217 3 Characters USD
8 Quantity The number of items Int Characters
9 trans_id Unique transaction ID. If error, the va lue is 0 1-20 characters  
10 fpn_id Unique FloCash ID 1-20 characters  
11 Custom Customer Id 1-25 characters  
12 Customer Customer Name 1-250 character  
13 Status Transaction Status Refer to status code in Appendix A Int  
14 status_msg Status message 1-250 characters  
15 payer_email Buyers email 1-250 characters  
16 payment_channel Payment channel buyer used mobile, card, wallet 1-250 characters  
17 txn_partner_ref Transaction reference returned back from bank 1-250 characters