developer guide: virtualmerchant - · pdf filevirtualmerchant developer guide.docx page 5 of...

Two Concourse Parkway, Suite 800, Atlanta, GA 30328 Elavon, Incorporated 2012. Al l Rights Reserved
Developer Guide: VirtualMerchant

VirtualMerchant Developer Guide.docx Page 2 of 239
Copyright
Copyright 2012 Elavon, Incorporated. All rights reserved. No part of this publication may be reproduced or distributed without the prior consent of Elavon, Inc., Two Concourse Parkway, Suite 800, Atlanta, GA 30328
Disclaimer
Elavon, Inc., provides this publication as is without warranty of any kind, either expressed or implied. This publication could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. Elavon, Inc., may make improvements and/or changes in the product(s) and/or program(s) described in this publication at any time.
Trademarks
VirtualMerchant is a registered trademark of Elavon, Inc. All other brand and product names are trademarks or registered trademarks of their respective companies.
Related Documents
VirtualMerchant User Guide (Document # DG-001-10-DO-Orig)
Typographical Conventions
Throughout this user guide you will see words and phrases that appear in different fonts and formats. The following table describes the typographical conventions used in this user guide.
Item Convention Example
Notes containing important information
Denoted by a change in font and possibly color; bold NOTE: This is an example.
Reference document titles Bold italics Batch Management tasks are
covered in a separate document,
the Batch Management User
Guide.
Sample Code Fixed-width font (Courier New) Sample Code 123 45
Typed Commands Fixed-width font (Courier
New); bold Type cd \Elavon\pbase in a
command window.
Certified by Elavon Stakeholders The quality and accuracy of content has been Certified by Elavon Stakeholders.

Contents
Chapter 1 Introduction .............................................................................................................................................................. 7
Chapter 2 Getting Started ......................................................................................................................................................... 8
Getting a Unique Test Account ................................................................................................................................................ 8
Communicat ing with VirtualMerchant ................................................................................................................................... 9
Chapter 3 Processing Transactions ....................................................................................................................................... 13
Processing Standard Transactions.......................................................................................................................................... 13
To Submit Standard Transactions ..................................................................................................................................... 13
To Modify Standard Transactions ..................................................................................................................................... 17
Enhanced Cred it .............................................................................................................................................................. 17
Void a Transaction .......................................................................................................................................................... 18
Delete a Transaction ....................................................................................................................................................... 18
Update a Tip on a Transaction ...................................................................................................................................... 18
Add a Signature ............................................................................................................................................................... 19
Processing Recurring and Installment Transactions ........................................................................................................... 20
To Add Recurring and Installment Transactions ............................................................................................................ 20
To Modify Recurring and Installment Transactions ...................................................................................................... 22
Update Recurring and Installment Transactions........................................................................................................ 22
Delete Recurring and Installment Transactions ......................................................................................................... 23
Submit Recurring and Installment Transactions for Payment ................................................................................. 23
Processing Batch Import Transactions .................................................................................................................................. 24
To Process Credit Batch Import ........................................................................................................................................ 25
To Process Recurring Batch Import .................................................................................................................................. 26
Processing Using Fraud Prevention Rules ............................................................................................................................ 27
Merchant IP Address Filter ................................................................................................................................................ 27
IP Address Filter................................................................................................................................................................... 28
Billing Country Filter .......................................................................................................................................................... 28
Shipping Country Filter....................................................................................................................................................... 29
IP Address & Billing Country Mis match Filter .............................................................................................................. 30
IP Address & Shipping Country Mis match Filter .......................................................................................................... 31
Email Address Filter ............................................................................................................................................................ 32
Card Number Filter .............................................................................................................................................................. 33
Email Domain Filter ............................................................................................................................................................ 34
Chapter 4 Payment Integration .............................................................................................................................................. 35
Authentication ........................................................................................................................................................................... 35

Payment Form ........................................................................................................................................................................... 36
Merchant Payment Form..................................................................................................................................................... 36
VirtualMerchant Payment Form ........................................................................................................................................ 37
Receipts Form............................................................................................................................................................................ 39
Merchant Receipt ................................................................................................................................................................. 39
VirtualMerchant Receipt..................................................................................................................................................... 40
Chapter 5 Transaction Flows ................................................................................................................................................. 42
Standard Transactions .............................................................................................................................................................. 42
Transaction Flow.................................................................................................................................................................. 42
Transaction Exampl