Sales Payment Parameters

note

Action request URL for SALES : com.finexuscards.yippiepos.xxx.SALES

Request Parameters

info

Configure the field PmtType 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 "02" - Android EDC "03" - Self-service Kiosk "04" - ARM - Payment terminal at top right "05" - Web based
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 "VOD" - Void 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"

Response Parameters

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.	"PN"