Parameter Name Data Type (Data Length) Description Channel
Mobile Kenswitch Credit Card
live numeric (1) LIVE or DEMO mode (1 or 0).
“1”
By Default (live)
Y Y Y
mm numeric (1) Display the Mobile Money Channel (on or off).
“on”
by Default (
i.e. mm=1
)
Y Y Y
mb numeric (1) Display the Mobile Banking Channel (on or off).
“on”
by Default (
i.e. mb=1
)
Y Y Y
dc numeric (1) Display the Debit Card Channel (on or off).
“on”
by
Default (
i.e. dc=1
)
Y Y Y
cc numeric (1) Display the Credit Card Channel (on or off).
“on”
by Default (
i.e. cc=1
)
Y Y Y
mer alphanumeric Merchant Name Y Y Y
oid alphanumeric (12) Order ID Y Y Y
inv alphanumeric (15) Invoice Number (Set to Order ID value above if NULL) Y Y Y
ttl numeric (15) Total amount (DO NOT PASS any commas as a
thousands separator). e.g. ttl=1234.00 and NOT
ttl=1,234.00
Y Y Y
tel alphanumeric (15) Customer Telephone number Y Y Y
eml alphanumeric (30) Customer Email Address Y Y Y
vid alphanumeric (12) V
endor ID assigned by
iPay.
SET IN LOWER CASE
Y Y Y
cur alphanumeric (3) Currency Type (USD or KES)
*
KES By Default
N N Y
p1 alphanumeric (15) Optional field. allows sending & receiving your custom
parameters
O O O
p2 alphanumeric (15) Optional field. allows sending & receiving your custom
parameters
O O O
p3 alphanumeric (15) Optional field. allows sending & receiving your custom
parameters
O O O
p4 alphanumeric (15) Optional field. allows sending & receiving your custom
parameters
O O O
cbk alphanumeric (100) Holds the value of the URL on your server that iPay
will communicate / call back to
Y Y Y
cst numeric (1) The customer email notification flag of value 1 or 0.
(
Set to
“1”
By Default
to allow customer to receive
txn notifications from
iPay
for online txns)
Y Y Y
crl numeric (1) Name of the cURL flag input field (1 character). The
value is 2, 1 or 0 to specify that you want to pick call
back values as a data stream. (
Set to
“0”
By Default
)
O O O
hsh alphanumeric (64) The computed
iPay
Hash Code
Y Y Y

The following characters are NOT ALLOWED as part of your incoming parameters: ; : ~ ` ! % ^ * > < The variables you need to pick via the call back URL and returned through a GET call are: status, id and ivm, and special browser-dependent variables qwh, afd, poi, uyt, ifd, agt. These variables are very important especially when you need to re-validate the transaction as shown on page 6 The extra variables p1, p2, p3 and p4 are used by you if you want to pass certain variables into the iPay system and receive them back intact on your end for your own personal reasons. They are not processed in any way. The mc variable is used to notify you of the actual mobile money transferred by the user.