PAYMENT PARAMETERS
Field | Field Description | Requirement | Expected Values | Format |
---|---|---|---|---|
amount | Mandatory | Transaction Amount in Kobo denomination (Eg 200000 for ₦2,000) | Value decided by Merchant | Numeric |
currency | Mandatory | Currency of the transaction | 566 (Naira) | Numeric |
cust_id | Mandatory | Unique Identifier for customer on Merchant’s own website | Merchant Provide | Alphanumeric |
hash | Mandatory | A Hashed value of selected combined parameters (See here for more details) | Value decided by Merchant | Alphanumeric |
txn_ref | Mandatory | Transaction Reference or identifier. Each and every transaction must have an identifier or reference. No 2 transactions must share the same reference (duplicates not allowed). This Reference Number must be generated by your web site/portal and a unique value must be sent for each transaction (max 15 characters) | Value decided by Merchant | Alphanumeric |
pay_item_id | Mandatory | Merchant Payment Item Identifier on WebPAY | Provided by Interswitch | Numeric |
product_id | Mandatory | Merchant Product Identifier on WebPAY. | Provided by Interswitch | Numeric |
site_redirect_url | Mandatory | URL of the page on your web site/portal user is to be redirected to after payment. Note: You may want to add encrypted authentication information to allow a user renter the web site/portal transparently without being challenged | Value decided by Merchant | Alphanumeric |
Below are the optional parameters
Field | Field Description | Requirement | Expected Values | Format |
---|---|---|---|---|
cust_id_desc | Optional | Customer Identification Number description. A descriptive name/label for Customer Identification Number above. | Value decided by Merchant | Alphanumeric |
cust_name | Optional | Name of customer as specified on Merchant’s website | Value decided by Merchant | Alphanumeric |
Cust_name_desc | Optional | Customer Name Description. A descriptive name/label for Customer Name above. | Value decided by Merchant | Alphanumeric |
local_date_time | Optional | Local Transaction Date Time in format DD–MMM–YY HH:MM:SS | Value decided by Merchant | DateTime |
site_name | Optional | Internet site name of the web site/ portal from which http post is coming from (E.g. www.mycompany.com) Note: This internet site name will be authenticated. | Value decided by Merchant | Alphanumeric |
pay_item_name | Optional | Internet site name of the web site/ portal from which http post is coming from (E.g. www.mycompany.com) Note: This internet site name will be authenticated. | Provided by Interswitch | Numeric |