Web2Pay - Hosted Payment Page

Key message for Hosted Payment Page

Web2Pay Hosted Payment Page is a page that is securely hosted by Flo2Cash. To use it, your website checkout page would make a HTTP POST to our secure hosted payment page. Your customer is then redirected to the Flo2Cash payment page to complete the payment step. Once the payment has been completed, the Flo2Cash payment page then sends the payment result back to your website via HTTP POST.

There are four simple steps to follow when setting-up your Web2Pay Hosted Payment page on your site.

  1. Retrieve your Account ID
  2. Create your Payment Request Form
  3. Submit Form in the Hosted Payment Page
  4. Finished!


Flo2Cash Secure Hosted Payment Page


Quick Start

Below is a quick start guide shows you how to setup Web2Pay Hosted Payment Page on your site in a few easy steps.

In order to get up and running you will require the account_id (issued by Flo2Cash), amount (the transaction amount in NZ dollars), item_name (description of the item), a reference (merchant reference to identify the transaction) and a return_url (the URL where the customer will be sent to after the payment is completed).

Step 1 - Retrieve your account_id

Login to the merchant console to retrieve your account_id. This is located under the My Profile > Accounts section.


Step 2 - Create the payment request form

Build a page that will POST the following required fields and place it on your website/linked to a product on your website in order to start accepting payments. Below is a example:

FIELD NAME
VALUE

cmd
x_click

account_id
620420

amount
10.00

item_name
ORDER#12321

reference
CUST#21232

return_url
http://www.flo2cash.com/transaction_result_page/

You can perform the same HTTP POST command in other web languages.

<f orm action ="https://secure.flo2cash.co.nz/web2pay/default.aspx" method ="post">

                < input type ="hidden" name ="cmd" value ="_xclick"/>

                < input type ="hidden" name ="account_id" value ="620420"/>    

                < input type ="hidden" name ="amount" value ="10.00"/>

                < input type ="hidden" name ="item_name" value ="Demo Product"/>

                < input type ="hidden" name ="reference" value ="test123"/>

< input type ="hidden" name ="return_url" value ="http://www.flo2cash.co.nz/"/>

                < input type ="submit" value ="Pay Now" />

</ form >
 
 

Step 3 - Hosted Payment Page

The hosted credit card payment page is generated and this will allow you to process transactions in a safe and secure environment.


Step 4 - Finished!

At this point, everything should be configured and ready for you to start accepting payments in a safe and secure manner, if you require advance configuration and customisation options please refer to our developer’s user manual



Using the Demo system and test credit cards

When using the Demo system, the URL to which you will be POSTing the payment requests to is different:

  • Demo Transactions URL: http://demo.flo2cash.co.nz/web2pay/default.aspx
  • Live Transactions URL: https://secure.flo2cash.co.nz/web2pay/default.aspx

Test Credit Card Numbers

All transactions made within the demo system must be done so with the credit card details below. Any other card numbers will be declined.

CARD TYPE
CARD NUMBER
EXPIRY DATE
CSC

MasterCard
5123456789012346
05/13
111

Visa
4987654321098769
05/13
111

Visa
4005550000000001
05/13
111

Amex
345678901234564
05/13
1111

Diners Club
30123456789019
05/13
N/A

The transaction amount must be rounded to a whole dollar for successful transactions. There are various cent amounts that can be used to return certain fail situations.

CENT AMOUNT
EXPECTED RESULT

.00
Transaction Successful

.10
Transaction could not be processed

.05
Transaction Declined - Contact Bank

.68
No Reply from Bank

.54
Card has expired

.51
Insufficient Funds


More information

For more information please refer to our developer's API.


↑TOP
Play Video