Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The very step to avoid difficult integration times: unit test the external communication with ACE.

Topics covered:

  • Trace in ACE

...

  • Polling from payment application

  • Manage gpiPolling error codes

  • Send an online authorization message

Code Block
breakoutModewide
languagec
// NAME.......  Tutorial #8
// PURPOSE....	This code presents how to poll for card from payment application
//
//	Hypothesis and optimizations:
//		Communication between ACE and acceptance device is IP
//
// PROJECT....  Wiki
// REFERENCES.	--
//
// Copyright ©2005-2020 - 9164-4187 QUEBEC INC (“AMADIS”), All Rights Reserved
//
//---------------------------------------------------------
//            Main
//---------------------------------------------------------
int main(int argc, char** argv)
{
	// See previous examples to get a PAYMENT request from ACE

	processRequest(buffer+1,len-1,pay);

	char* parameters;
	tStartingPoint sp = spSTART_A; // To initiate contactless transaction at preprocessing step
	char line1[100]="",line2[100]="";

	// Initialize GPI
	// This is platform dependent. On Kizis AVT, this set PCSC readers' name from agnos.ini
	gpiMain(0,&parameters);

	// Load available kernels
	enpConnectPaymentServices("./AGNOS/");
	
	// Set contactless configurations
	dtmInitializeFromFile("./AGNOS/",NULL,NULL,NULL,NULL,NULL,pay->mTransactionType,bFALSE);

	// Initialization entry point
	enpInitialize("","",bFALSE,bFALSE,bFALSE,pay); // No more signal managed now

	tTerminalContext *terminalCtx = NULL;
	tByte technoToDetect = TECHNO_CL_TYPE_EMV;
	tGPIError gpiError = 0;

	terminalCtx = (tTerminalContext*)dtmGetData(TERMINAL_CTX);

	if(terminalCtx->mMagstripe)
	{
		technoToDetect |= TECHNO_MAGSTRIPE;
	}
	if(terminalCtx->mEMVContact)
	{
		technoToDetect |= TECHNO_CONTACT;
	}

	gpiSetTechnoToDetect(technoToDetect);

	sprintf(line1,"PAY");
	if(pay->mAmount)
	{
		sprintf(line2,"AMOUNT: %.2f",(*pay->mAmount)/100.0);
	}
	else
	{
		sprintf(line2,"--");
	}

	gpiDisplayMessage(gpi_true,line1);
	gpiDisplayMessage(gpi_false,line2);

	gpiError = gpiPolling("",5); // timeout set to 5 seconds
	sprintf(tmp,"GPI ERROR: 0x%.4X\n",gpiError);
	aceOut(tmp);
	if(scrINTERRUPTED == gpiError)
	{
		sprintf(tmp,"TRANSACTION INTERRUPTED\n");
		aceOut(tmp);
	}
	else if(polTIMEOUT == gpiError)
	{
		sprintf(tmp,"No Tap\n");
		aceOut(tmp);
	}
	else
	{
		sprintf(tmp,"CARD DETECTED FROM L3\n");
		aceOut(tmp);

		enpSkipPollingOnNextStartB(gpiError);
		enpExecutePaymentTransaction(sp,pay,out); // Call main entry point primitive to trigger a transaction

		if (ocONLINE_REQUEST == out->mOutCome)
		{
			gpiDisplayMessage(gpi_true,"ONLINE");
			length = 0;
			pmwGetEMVData(	pay->mSession,(tByte*)"\x9F\x02\x95\x9F\x26\x9F\x27",7,
							pay->mDataExchange.mDataRecord.mStream,&pay->mDataExchange.mDataRecord.mLength);

			// For example, use ACE to emulate online auth.
			aceSendContactlessAuthorization(pay,bFALSE);

			if (TC == pay->mCID)
			{
				gpiDisplayMessage(gpi_true,"APPROVED");
			}
			else
			{
				gpiDisplayMessage(gpi_true,"DECLINED");
			}
		}
		else if (ocAPPROVED == out->mOutCome)
		{
			gpiDisplayMessage(gpi_true,"APPROVED");
		}
		else
		{
			gpiDisplayMessage(gpi_true,"DECLINED");
		}
	}

	// Clean session closing (will switch antenna off)
	pay->mDataExchange.mError.mL1 = erL1OK; // Avoid display message within entry point
	out->mUIReqOnRestartPresent = bFALSE; // Avoid display message within entry point
	enpExecutePaymentTransaction(spNO_START,pay,out);

	// Acknowledge ACE and sends several tags for receipt printing...
	ackPayment(pay,out,((pay->mPOSEntryMode == EMV_CL_MODE) || (pay->mPOSEntryMode == MAG_CL_MODE)));

	// UI stuff..
	gpiClearScreen();
	gpiDisplayMessageByID(gpi_true,currentLanguage,THANKS);

	gpiSwitchLED(LED_1,gpi_false,0);
	gpiSwitchLED(LED_2,gpi_false,0);
	gpiSwitchLED(LED_3,gpi_false,0);
	gpiSwitchLED(LED_4,gpi_false,0);

	aceOut("Training Session - END\n");

	return 0;
}

...