bool Confirm(string)
Finalizes an unconfirmed PreAuth transaction and returns the result via the OnKioEMVTransactionCompleted callback.
Security
Trust Level Required: Full Trust
Parameters
Name | Description |
input |
string Serialized JSON string with the following parameters from the EMVRequestInput class: PaymentAmount, TaxAmount, TransactionRef, CardToken, AuthCode, AcqRefData, ProcessData, and (optional) DeviceName. |
Return
True if the command was queued for processing, false otherwise.
Remarks
After successfully running a PreAuth transaction, the transaction must then be confirmed or voided. This call concludes the two-step PreAuth transaction. This transaction type is not supported by NETePay. TaxAmount is only required by Shift4.
Examples
var input1 = {
"PaymentAmount": 425
};
if (!KioEMVDevice.Payment(input1))
alert('Failed to call Payment!');
var TransTypes = {
"None": 0,
"SetParameters": 1,
"Payment": 2, // PreAuth
"Confirm": 3, // PreAuth Capture
"Terminate": 4,
"VoidTrans": 5,
"Refund": 6,
"SetIdleMsg": 7,
"Sale": 8,
"VoidSale": 9,
"Reset": 10,
"RequestTMSUpdate": 11
};
var ResultTypes = {
"Unknown": 0,
"Approved": 1,
"Declined": 2,
"Error": 3
};
// callback fired when operation processed
function OnKioEMVTransactionCompleted(lastTransResult) {
// did the event fire because of a payment request finished?
if (lastTransResult.TransType == TransTypes.Payment) {
// it was approved -- try to confirm it.
if (lastTransResult.Result == ResultTypes.Approved) {
var input2 = {
"PaymentAmount": lastTransResult.Amount,
"TaxAmount": lastTransResult.Tax,
"TransactionRef": lastTransResult.ReferenceID,
"CardToken": lastTransResult.CardHashToken,
"AuthCode": lastTransResult.AuthorizationCode,
"AcqRefData": lastTransResult.AcqRefData,
"ProcessData": lastTransResult.ProcessData,
"DeviceName": "MyDevice"
};
if (!KioEMVDevice.Confirm(input2))
alert('Failed to call confirm');
}
else {
alert('Payment failed, Operation returned: ' + lastTransResult.Result);
}
}
// or did it fire because a confirm finished?
if (lastTransResult.TransType == TransTypes.Confirm) {
if (lastTransResult.Result == ResultTypes.Approved) {
alert('Tranaction confirmed!');
}
else {
alert('Failed to confirm transaction, Operation returned: ' + lastTransResult.Result);
}
}
}
Requirements
KioWare for Windows version 8.24 or greater.