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 |
| payment_params | Optional | To activate miscellaneous payment parameters (For more details on sending SPLIT click here) | Value decided by Merchant | Alphanumeric |
| xml_data | Optional | Any other data that needs to be sent will be packaged in XML Format and put in this field. Bank details of payments that are to be SPLI are specified here (For more details on sending SPLIT click here) | Value decided by Merchant | XML |