Parameters & Description
Parameters
Parameters Name
Data Types
Required
Description
merchantCode
string
Yes
Provided by Platform Payments
Ex: KW23281
authKey
string
Yes
Provided by Platform Payments
Ex: eaOZH3MnSslWexl
currency
string
Yes
pc
string
Yes
Ex: KWKNETDC for KNET
BHBENEFITDC for Benefit
EGUPGCC for Meeza
b) To show all payment methods use the code "all".
Ex: all
c) For specific country payment methods, use the code "currency"
and the pass desired country's standard three letter currency code in currency parameter.
Ex: currency
tunnel
string
Optional
Provided by OG if requires.
amount
double
Yes
Your customer transaction amount. Ex: 1.000
doConvert
string
Yes
When the amount needs to be converted to other currency, then the value should be "Y", else "N".
sourceCurrency
string
Conditional
When the amount needs to be converted the other currency, then pass standard three letter currency code. ( KWD, BHD, USD, EGP, SAR, GBP, EUR, etc.)
Ex: If Amount to be converted from USD to KWD, then doConvert=Y and sourceCurrency=USD
description
string
Optional
Your product/item name or description.
referenceID
long
Yes
Must be 15 digits unique number.
Ex: 123456789012345
timeStamp
string
Yes
Current Date & Time when the payment's URL generating.
Ex: 202101241619123
language
string
Optional
English (en) / Arabic (ar)
callbackURL
string
Yes
Once the transaction is completed, the customer will be redirected to the given response URL.
Ex: https://yourdomain.com/Calback
userreference
long
Conditional
Your customer's mobile number or any unique number (minimum 8 digits and maximum 15 digits) for Quick Pay service.
Example: KFAST for KNET
Which the customer can save their card(s) details, enabling them to carry out any future transactions with the same merchant, in a speedy manner, by only having to enter their PIN when prompted.
Note: Quick Pay service should be enabled for the merchant by OG, in order to use this service.
Ex: 12345678
hash
string
Yes
Ex: B400HJKHKJ00000JKHJKHKJJK032321JKHFJKHF
BillingDetails
fName
string
Optional
Your customer's First Name.
lName
string
Optional
Your customer's Last Name.
mobile
string
Optional
You customer's Mobile Number.
email
string
Optional
Your customer's Email.
city
string
Optional
Your customer's Shipping City.
pincode
string
Optional
Your customer's Postal/Zip Code.
state
string
Optional
Your customer's Billing State.
address1
string
Optional
Your customer's Billing Address.
address2
string
Optional
Your customer's Billing Address.
Last updated