Sales Payment Parameters
The action request URL for SALES is com.finexuscards.yippiepos.xxx.SALES
- Request Parameters
- Response Parameters
Configure the PmtType field for Card and QR payment options.
Mandatory / Conditional Fields
| Field Name | Type | Length | Description | Example |
|---|---|---|---|---|
MsgVer | String | 20 | Version number echo from the request. | "1.0" |
PmtType | Int | 2 | Type of payment. | "00" - KPOS will display all available payment method, the customer can then choose their preferred method to proceed. "01" - Card payment "04" - Duitnow QR payment (Merchant presented) "08" - Alipay+ QR payment (Merchant presented) |
CallerDeviceType | String | 20 | Caller device type. | "01" - Mobile Device "03" - Self-service Kiosk |
CallerDeviceVer | String | 20 | Application version number of the caller device. | "2.0.1" |
TxnID | String | 50 | Unique transaction ID assigned by caller application. Note: Caller app, may generate a random UUID for this purpose. | "C5460ED3C5574F71AEFD63C1FDE495E5" |
LocalTxnDTTime | Int | 14 | Local date and time of transaction – Format: YYYYMMDDMMDDhhmmss | "20200131091025" |
Email | String | 100 | User email address to login. | "wyongkeat@email.com" |
Pwd | String | 16 | User password to login. | "ABCD1234" |
AmtTxn | Number | 12 | (Amount, Transaction) The purchase transaction amount in supported currency. No decimal point appears in this field; the decimal place is implied in Exponent of Transaction Amount according to CrcyTxn defined in ISO 4217 numeric currency code. | "000000010000" |
CrcyTxn | Int | 3 | ISO 4217 numeric currency code of this transaction. | "458" |
TxnTyp | String | 3 | Conditional field Transaction type. Mandatory if mQPOS integrate with ECR via Bluetooth or Serial Cable. | "STX" - Sale transaction |
Optional Fields
| Field Name | Type | Length | Description | Example |
|---|---|---|---|---|
Description | String | 256 | Order description | "Nasi Goreng" |
OptInPrintReceipt | String | 1 | Opt-in print receipt feature. | "Y" - Print receipt button is visible. "N" - Print receipt button is invisible. Default is "Y" |
OptInSendEReceipt | String | 1 | Opt-in send e-receipt feature. | "Y" - Send e-receipt button is visible. "N" - Send e-receipt button is invisible. Default is "Y" |
OptInEReceipt | String | 1 | Opt-in e-receipt feature. | "Y" - E-receipt will be showed if card payment successful. "N" - E-receipt will not be showed if card payment successful. Default is "Y" |
OptInPmtAckmnt | String | 1 | Opt-in payment acknowledgement feature. | "Y" - Payment acknowledgement will be showed if payment successful. "N" - Payment acknowledgement will not be showed if payment successful. Default is "Y" |
Mandatory / Conditional Fields
| Field Name | Type | Length | Description | Example |
|---|---|---|---|---|
MsgVer | String | 20 | Version number echo from the request. | "1.0" |
TxnID | String | 20 | Transaction ID from the request. | "79112E72300E440891F60E14039C2DFD" |
ResultCode | String | 3 | Result code responded by mQPOS. It is the resultCode parameter in onActivityResult() *Note: Caller app shall examine this field and determine whether the payment transaction was completed successfully or failed. Please refer to Appendix 3 for details. | "00" |
RespCd | String | 2 | Conditional field Response returned from acquiring host. Please refer to Appendix 2 for details. | "00" |
OrgRespCd | String | 2 | Conditional field Original response code from issuer/bank. | "00" |
RRN | String | 12 | Conditional field A retrieval ref number generated by the acquirer host. | "307219058382" |
STAN | String | 6 | Conditional field Returned by host, set in result Intent. System Trace Audit Number of the original transaction. | "058382" |
AuthIdResp | String | 16 | Conditional field Authorization code from issuer/bank for approved transaction only. The consumer should use this code as the reference to the approved payment transaction. | "484684" |
MRN | String | 40 | Conditional field Merchant Reference Number from acquiring host. This field is also typically known as Invoice Number that is used by merchant to reconcile the card payment slips and their sales transaction. | "23072AMgLI" |
TxnDTTime | String | 14 | Conditional field Date and time of the transaction takes place in GMT+8 time. Format: YYYYMMDDhhmmss | "20230313190732" |
MaskedPAN | String | 19 | Conditional field Return Masked PAN. As per current PCI-DSS 3.2, this field contains only first 6 and last 4 digits of card number/primary account number used to complete the card payment. | "443322xxxxxx1234" |
PaymentScheme | String | 20 | Conditional field Payment scheme of the transaction. | "AF" - Ant Financial (Alipay) "JC" - JCB "MC" - MasterCard "PN" - Paynet (DuitNow) "UP" - UnionPay (fka CUP) "VS" - Visa |