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='[e-mail]'/>
  <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'.