Comment on page

Simple HTML Form

VoguePay can be integrated into your application via HTML form following these easy steps, making it the easiest way to start accepting payments
1. Pass required Information in HTML Form
To initialize a transaction, you'll need to pass information such as merchant ID, memo, amount, item name, item description, item value, merchant reference (transaction reference) etc. Merchant ID, memo and amount are required. Here is the full list of parameters you can pass:
Params
Required
Description
v_merchant_id
Yes
Merchant ID
merchant_ref
No
Merchant Reference or Transaction Reference. Can be any value provided by merchant. Merchant value will be returned with the confirmation results from the confirmation API. VoguePay doesn't need this value, it is used by the merchant to store any data to be retrieved later with the transaction details.
memo
Yes
Transaction Memo
cur
Yes
Currency code. e.g NGN
developer_code
No
A code unique given to every developer. Using this code earns the developer a commission on every successful transaction made through any selected integration methods.
total
Yes
Total Cost
email
Yes
Merchant's Email
notify_url
Yes
Link to Send Transaction status/details to
success_url
Yes
Link to redirect users to if payment is successful
fail_url
Yes
Link to redirect users to if payment is fails.
2. Add VoguePay Link in HTML Form Action attribute
To get VoguePay Payment window, It is required to add VoguePay Payment Link as the value of your HTML Form Action attribute.
See code snippets below.
<form method='POST' action='https://pay.voguepay.com'>
</form>
<form method='POST' action='https://pay.voguepay.com'>
<input type="hidden" name='v_merchant_id' value='sandbox_760e43f202878f651659820234cad9' />
<input type="hidden" name='merchant_ref' value='234-567-890' />
<input type="hidden" name='memo' value='Bulk order from McAckney Web Shop' />
<input type="hidden" name='item_1' value='Face Cap' />
<input type="hidden" name='description_1' value='Blue Zizi facecap' />
<input type="hidden" name='price_1' value='2000' />
<input type="hidden" name='item_2' value='Laban T-shirt' />
<input type="hidden" name='description_2' value='Green XXL' />
<input type="hidden" name='price_2' value='3000' />
<input type="hidden" name='cur' value='NGN' />
<input type="hidden" name='item_3' value='Black Noni Shoe' />
<input type="hidden" name='description_3' value='Size 42' />
<input type="hidden" name='price_3' value='8000' />
<input type="hidden" name='developer_code' value='pq7778ehh9YbZ' />
<input type="hidden" name='total' value='13000' />
<input type="hidden" name='name' value='Customer name'/>
<input type="hidden" name='address' value='Customer Address'/>
<input type="hidden" name='city' value='Customer City'/>
<input type="hidden" name='state' value='Customer State'/>
<input type="hidden" name='zipcode' value='Customer Zip/Post Code'/>
<input type="hidden" name='email' value='[email protected]'/>
<input type="hidden" name='phone' value= 'Customer phone' />
<input type="hidden" name='notify_url' value= 'https://example.com/notification.php'/>
<input type="hidden" name='fail_url' value= 'https://example.com/notification.php'/>
<input type="hidden" name='success_url' value= 'https://example.com/notification.php'/>
<input type='submit' alt='Submit' />
</form>
<!-- Demo Link: https://codepen.io/sakarious/pen/yLbWyNB -->
For notification, if a URL is provided in 'notify_url', a transaction notification will be sent. If transaction is successful, customers are automatically redirected to 'success_url'.