QuickPay Query Response Parameters

📘

Data Attribute Reference

Data Type

  • A: Alphabet
  • AN: Alphanumeric
  • C: Characters
  • B: Boolean
  • D: Decimal
  • N: Numeric

Mandatory attributes

  • M: Mandatory
  • C: Conditional
  • O: Optional
ParameterData Type / LengthMandatoryDescription
versionAN 3MRequest version number

Current version: 2.4
timeStampAN 14MRequest time stamp

* In yyyyMMddHHmmss format
qpIDN 10MQuickPay ID
orderIdPrefixAN 14MPrefix of merchant order number for transaction done using this QuickPay URL

* Accepts only alphanumeric characters
and the special characters _-
descriptionAN 150MDescription of QuickPay URL

* Accepts only
alphanumeric characters and the special characters ._#-
currencyAN 3MStandard ISO4217 currency codes

Examples:
Thai baht = THB
Singapore
dollar = SGD
* US dollar = USD
amountAN 12MTransaction amount

Examples:
SGD =
100.00
JPY = 100
allowMultiplePaymentC 1MSets QuickPay link to allow multiple payments

Y = Yes
N = No

Default value: N
maxTransactionN 4MMaximum number of approved transactions

Based on number of items to sell (e.g., merchants with 10 items to sell must put a value of 10)
Accepts values from 1 to 1000
expiryAN 1MExpiry date of the QuickPay link

* In yyyy-MM-dd HH:mm:ss format
userData1AN 255MUser data
userData2AN 255MUser data
userData3AN 255MUser data
userData4AN 255MUser data
userData5AN 255MUser data
promotionAN 20MPromotion code to filter promotion transactions
categoryIdAN 20MPredefined payment category code for reporting purposes
resultUrl1AN 255MFrontend return URL
resultUrl2AN 255MBackend return URL
paymentOptionC 1MTo restrict customer payment methods / channels:

F: Full amount payment only
I: Installment payment plan only
C: Credit card payment only
A: All available options

By default, Option A is selected
ippInterestTypeC 1MTo indicate IPP (Installment Payment Plan)
interest type:
M: Merchant Pay interest option only
C: Customer Pay interest option only
* A: all available options

By default, Option A is selected
paymentExpiryAN 19MTo specify payment expiry date and time for 123 service:

Expiry value is taken from the merchant configuration in the 2C2P portal
By default, uses the format
yyyy-MM-dd HH:mm:ss
urlAN 255MQuickPay URL
currentApprovedN 5MCurrent total approved transactions
clickCountN 5MNumber of clicks of the QuickPay URL
request3DSC 1OTo enable / disable / force 3DS authentication:
Y: Enable 3DS authentication
N: Disable 3DS authentication
* F: Force 3DS authentication (only accepts
ECI 02/05)

By default, 3DS authentication is enabled
enableStoreCardC 1OTo enable card tokenization feature:
N: Disable tokenization
Y: Enable tokenization

By default, tokenization is disabled
recurringC 1OTo enable RPP (Recurring Payment Plan):
N: Disable RPP
Y: Enable RPP feature

By default, RPP is disabled.

If RPP is enabled, the payment response will return the RPP unique ID
recurringAmountD 12CRecurring amount

Examples:
SGD = 100.00
JPY = 100
allowAccumulateC 1CAllows a certain amount of failed RPP transactions before the RPP is terminated
maxAccumulateAmountD 12CSet the maximum accumulated failed transaction amount. If this amount is exceeded, the RPP will be terminated.

* Only required if allowAccumulate is enabled
recurringIntervalN 3CIndicate the frequency of RPP charges, in days

Minimum: Every 1 day
Maximum: Every 365 days (1 year)
* Only required if RPP is enabled and chargeOnDate is disabled
recurringCountN 5CIndicate how many times to charge a customer with RPP

Set to '0' to charge indefinitely until terminated manually
Only required if RPP is enabled
chargeNextDateC 8CIndicate the next RPP charge date

Format: ddMMyyyy
Only required if RPP with
recurringInterval is set
For RPP configured with chargeOnDate,
chargeNextDate is optional
If chargeNextDate is not set, the month value from chargeOnDate will be used
chargeOnDateC 4CCharge RPP on specific date every month

Format: ddMM
MM is only used if
chargeNextDate is not set
Otherwise the day value will be used for every month
Only required if RPP is enabled and recurringInterval is disabled
useStoreCardOnlyC 1OTo allow merchant provide Store Card ID
storeCardUniqueIDC 20CStore Card ID
ippPeriodFilterC 200CAllow IPP Tenure selection
resCodeN 3MResponse status code

Refer to: Respone Code List
resDescAN 50MResponse status short description
hashValueAN 150MHMACSHA1 cryptographic hash value of:
version + timeStamp + qpID +
orderIdPrefix + description +
currency + amount +
allowMultiplePayment +
maxTransaction + expiry +
userData1 + userData2 +
userData3 + userData4 +
userData5 + promotion +
categoryId + resultUrl1 +
resultUrl2 + paymentOption +
ippInterestType + paymentExpiry +
url + currentApproved +
clickCount+ request3DS +
enableStoreCard + recurring +
recurringAmount +
allowAccumulate +
maxAccumulateAmount +
recurringInterval + recurringCount + chargeNextDate + chargeOnDate + useStoreCardOnly + storeCardUniqueID + IPPPeriodFilter + resCode + resDesc

* Uses secret key provided by 2C2P to merchant