ALIGNET MERCHANT SOLUTION Virtual POS (V-POS)

ALIGNET MERCHANT SOLUTION Virtual POS (V-POS) Merchant Integration Guide Technical-functional document that describes the process of integration of new commerce through the Virtual Point Of Sale (V-POS) to the AMS platform

Version 2.4.0 Updated: 19 de July de 2012

© 2008 - 2012 ALIGNET. All Rights reserved. This document is confidential. The contents and concepts developed in the document cannot be used by natural or legal entities to whom this information has not been sent explicitly to.

Review History Date 2005-08-25 2005-09-02

Version 0.1 0.2

2005-09-15

0.8

2005-09-19

0.9

Description Initial production of the document Definition of the objectives in the document Sequence diagram, several improvements Technical specifications

2005-09-19 2005-09-30 2005-11-30 2005-11-30 2005-12-06 2006-03-27 2006-05-30

1.0 1.2 1.3 1.3 1.4 1.5 1.5

Final review Key generation for the security outline Update on points 7, 8 , 9 Final review Update on points 7, 8 and appendixes Update on points 7, 8 and appendixes Review and control

2006-06-26

1.5

Payroll modification

2008-06-30 2009-01-20 2010-12-01

2.0.1 2.0.1 2.2.0

2012-07-19

2.4.0

General review General review Update definition of authorizationResult and errorCode fields. List of error codes Update of testing URL

Merchant Integration Guide Virtual POS (V-POS) ALIGNET Merchant Solution [Confidential – ALIGNET]

Author R. Barturen H. Alosilla R. Barturén J. Botta y D. Cruz D. Cruz D. Cruz R. Barturén D. Cruz R. Barturén R. Barturén T. J. Carrasco T. J. Carrasco M. Alcalá G. Quispe J. Bautista

J. Bautista

Page 1

Contents CONTENTS .....................................................................................................2 1. INTRODUCTION .......................................................................................3 1.1. OBJECTIVES .......................................................................................3 1.2. GLOSSARY .........................................................................................3 1.3. PURCHASE FLOW ...............................................................................3 1.4. PURCHASE EXPERIENCE .....................................................................5 2. WHAT IS V-POS? .....................................................................................8 2.1. DESCRIPTION .....................................................................................8 2.2. ARCHITECTURE ..................................................................................8 2.3. REQUEST AND RESPONSE OF THE PAYMENT FLOW ..............................9 3. V-POS INTEGRATION............................................................................10 3.1. V-POS INTEGRATION PROCESS ........................................................10 3.2. ADMINISTRATION OF CRYPTOGRAPHIC KEYS .......................................11 3.3. PAYMENT REQUEST ..........................................................................12 3.4. PAYMENT RESPONSE ..........................................................................1 4. INTEGRATION WITH THE PLUG-IN .......................................................1 5. FREQUENTLY ASKED QUESTIONS ......................................................2 6. ADDITIONAL ; $array_get['DIGITALSIGN']=""; $array_get['SESSIONKEY']="";

The keys can be write in the code:

Merchant Integration Guide Virtual POS (V-POS) ALIGNET Merchant Solution [Confidential – ALIGNET]

Page 23

//Example of a hard code key //Notice that \n are placed athe the end of the lines, are line jump hended for the PEM format

$llavePub

=

"-----BEGIN

PUBLIC

KEY-----\n".

"MIGJAoGBAKkJKIAJgm8/zA10FIpGUMAF6WTuTTKd1nqFHUokyXCNYn1oZAz6 vVqy\n". "BfJjWxL0o8r8ooBKQ/jKIVm4mFtVgQ5EamzYQFxsmU1dFfuBZdm7o3eId7xh mSnD\n". "ZNiwGv7xmTybY4QH7VMqPAgaeKN9cPAnN1+F2Jzw/WVWtD7E7xXhAgMBAAE= \n". "-----END RSA PUBLIC KEY-----"; The keys can be read it from a flat text existing in the S.O, too. //Initialization Vector $vector = "0000000000000000"; //Example of a key that is read from a plain text file $llavePriv = "file://camino_archivo_completo"; To execute the component, is necessary invocated the function VPOSSend with all the fields to send, the exit parameters of the function , the SESSIONKEY, el DIGITALSIGN y el XMLREQ will be returned in the exit array, in this case the array_get

VPOSSend($array_send,$array_get,$llaveVPOSCryptoPub,$llaveComercioFirma Priv,$VI);

Read the values incide of the array $array_get and send them by a form to the VPOS.

Merchant Integration Guide Virtual POS (V-POS) ALIGNET Merchant Solution [Confidential – ALIGNET]

Page 24

"> "> "> "> ">

Merchant Integration Guide Virtual POS (V-POS) ALIGNET Merchant Solution [Confidential – ALIGNET]

value="