传款易批事务处理用户指南V1.0.pdf

PayDollar PayGate User Guide for Batch Transaction Processing v1 0 Leave Blank Intentionally User Guide for Batch Transaction Processing Page 1 Copyright Information AsiaPay HK Limited Unit 1701 2 17 F K Wah Centre 191 Java Road Hong Kong Telephone 852 2538 8278 Fax 852 2545 3898 Web site This document and the software described by this document are copyright 2010 by AsiaPay HK Limited All rights reserved Use of the software described herein may only be done in accordance with the License Agreement provided with the software This document may not be reproduced in full or partial form except for the purpose of using the software described herein in accordance with the License Agreement provided with the software Information in this document is subject to change without notice Companies names and data used in the examples herein are fictitious unless otherwise noted All trademarks are the property of their respective owners This document is developed and produced in Hong Kong SAR User Guide for Batch Transaction Processing Page 2 Confidentiality and Usage The information contained in this document and any attachments is confidential information provided by AsiaPay HK Limited This document is intended only for use by merchants approved by AsiaPay Any copying distribution or dissemination of this document by any other parties is prohibited User Guide for Batch Transaction Processing Page 3 Revision History Revision Date Revision Description 1 0 Mar 03 2010 First issue User Guide for Batch Transaction Processing Page 4 Table of Contents 1 Overview 5 1 1 Introduction 5 2 Function of Batch Transaction Processing 6 2 1 Upload Batch File 7 2 2 Download Batch File 12 2 3 Batch Report 13 2 4 Back End Process 14 2 5 Check processing status 15 3 Appendix 1 3 1 Appendix A Batch File Sample 1 User Guide for Batch Transaction Processing Page 5 1 Overview 1 1 Introduction Batch Transaction Processing allows merchants to perform transaction processing in batch mode by submitting a batch file to the Web Server via our Batch Transaction Upload function at the Merchant Administration Site The Web Server parses the batch file and the resulting data will be passed to the Application Server for further processing and validation given there is no parse error Both parsing and processing of the file are performed at a scheduled time defined by our system or the processor Transaction processing begins if the validation is successful Thus the status and result of a batch file can be viewed in the Batch Report at the Merchant Administration site The Batch Transaction Processing currently supports 4 different types of actions which includes 1 Sales Requests 2 Authorization Requests 3 Capturing of previous online authorizations and 4 Refunds User Guide for Batch Transaction Processing Page 6 2 Functions of Batch Transaction Processing The Batch Transaction Processing is located at the Operations tab Batch Transaction Processing consists of i Upload Batch File ii Download Batch File and iii Batch Report User Guide for Batch Transaction Processing Page 7 2 1 Upload Batch File Step 1 Create a text file txt file which contains all the transactions prepared for upload In order to upload a batch of transactions successfully the text file format has to be as follows Each order request will consist of one TAG Header one TAG Footer and at least one TAG Detail Each TAG will contain 199 characters Use space to separate each field When the format of the field is Text put space at the front to extend the length otherwise put 0 at the front when the format of the field is Number For Capture and Refund only Action Type Payment Reference Number and Request Amount are the required fields Please put the default value i e space for other fields Sample file Download Sample file User Guide for Batch Transaction Processing Page 8 a Upload file format for TAG Header RH Field name Start index End index Length Format Description TAG 1 2 2 Text TAG value RH Header Batch Number 4 9 6 Number Batch Number Merchant Id 11 25 15 Number The merchant ID of your merchant account b Upload file format for TAG Footer RT Field name Start index End index Length Format Description TAG 1 2 2 Text TAG value RT Footer Number of Transaction s 4 11 8 Number Total number of transaction s in this patch Format 00000002 2 records Total Amount 12 27 16 Number Total amount in this patch with 2 decimal places Format 0000000000004000 40 00 User Guide for Batch Transaction Processing Page 9 c Upload file format for TAG Detail RD S Sale A Authorize C Capture R Refund Field name Required Start index End index Length Format Description TAG S A C R 1 2 2 Text TAG value RD Detail Action Type Result S A C R 4 6 3 Text Action Type and the result Format BRL Batch Refund Request BRF Batch Refund Failed BRS Batch Refund Success BCL Batch Capture Request BCF Batch Capture Failed BCS Batch Capture Success BSL Batch Sale Request BSF Batch Sale Failed BSS Batch Sale Success BAL Batch Authorize Request BAF Batch Authorize Failed BAS Batch Authorize Success Payment Reference Number C R 8 25 18 Number Payment Reference Number Request Amount S A C R 27 38 12 Number Request amount with 2 decimal places Format 000000002000 20 00 Date For output file only 40 47 8 Text Action Date Time For output file only 49 54 6 Text Action Time User Guide for Batch Transaction Processing Page 10 Order Reference S A 56 90 35 Text Merchant Reference Number Pay Method S A 92 101 10 Text Payment method VISA MasterCard Diners JCB AMEX Card No S A 103 118 16 Text Credit card number Card Holder S A 120 134 15 Text Credit card holder name Expiry Date S A 136 139 4 Text Credit card expiry date Format mmyy mm Credit card expiry month yy Credit card expiry year Security Code S A 141 144 4 Text Credit Card Verification Code VISA CVV2 3 digit MasterCard CVC2 3 digit American Express 4DBC 4 digit Target Date Optional S A C R 146 153 8 Text Target action date Transaction will be processed on the target date you have provided Date Format yyyymmdd Error Message For output file only 155 198 44 Text Error Message User Guide for Batch Transaction Processing Page 11 Step 2 Upload the file After the file is created in your disk you can go to the Upload Batch File link and you will see the screen as follow To upload the file click the Browse button to select the file created in your disk and then click the Upload button to transfer the batch file into our database The uploaded result with the Batch ID and No of Transaction queued will be shown User Guide for Batch Transaction Processing Page 12 2 2 Download Batch File You can download the batch file in txt file format to check the process status of each transaction by using the Download Batch File function Input the Batch ID of the uploaded batch file and then click the Download button to save the file User Guide for Batch Transaction Processing Page 13 2 3 Batch Report Choose your selection criteria and then click the View button to view the batch details that matches with your chosen time period batch ID or and status es Batch Report result as shown below User Guide for Batch Transaction Processing Page 14 2 4 Back End Process The submitted batch files will be processed by a back end processing agent in our system 4 times a day You may check the result in the Batch Report afterwards User Guide for Batch Transaction Processing Page 15 2 5 Check processing status Apart from viewing the status in the Batch Report an email notification will be sent to your Operation contact email after a batch processing is completed An example of the email is shown as below the number of transaction represent by xx Dear merchant name Thank you for using our batch transaction processing service We have successfully processed your request on yyyy mm dd as follows Total Transa