Optimal Payments Hosted Payments API Reference Guide
Total Page:16
File Type:pdf, Size:1020Kb
Optimal Payments Hosted Payments API Reference Guide December 2014 1.3.4 This manual and accompanying electronic media are proprietary products of Optimal Payments plc. They are to be used only by licensed users of the product. © 1999–2015 Optimal Payments plc. All rights reserved. The information within this document is subject to change without notice. The software described in this document is provid- ed under a license agreement, and may be used or copied only in accordance with this agreement. No part of this manual may be reproduced or transferred in any form or by any means without the express written consent of Optimal Payments plc. All other names, trademarks, and registered trademarks are the property of their respective owners. Optimal Payments plc makes no warranty, either express or implied, with respect to this product, its merchantability or fitness for a particular purpose, other than as expressly provided in the license agreement of this product. For further information, please contact Optimal Payments plc. International Head Office 3500 de Maisonneuve W., Suite 700 Montreal, Quebec H3Z 3C1 Canada Tel.: (514) 380-2700 Fax: (514) 380-2760 Email: [email protected] Technical support: [email protected] Web: www.optimalpayments.com U.K. Office Compass House, Vision Park Chivers Way, Histon Cambridge CB24 9AD United Kingdom Email: [email protected] Technical Support: [email protected] Web: www.optimalpayments.com U.S. Office 1209 Orange Street Wilmington, DE 19801 Gatineau Office 75 Promenade du Portage Gatineau, Quebec J8X 2J9 Canada Release Notes Release Notes Version Date Details 1.3.4 December 2014 • Added Pingit functionality 1.3.3 October 2014 • Added accordD functionality for select merchants 1.3.2 May 2014 • Added authCode parameter to order status response table and to Return Keys appendix • Updated HTML example in ThreatMetrix appendix • Added functionality for Giropay, NETELLER, PayPal, Sofort Banking and Ukash • Updated extended options key/value pairs table • Updated values for transaction.status parameter 1.3.1 February 2014 • Added MasterPass functionality • Updated extended options key/value pairs table 1.3 October 2013 • Updated extended options key/value pairs table • Added section for rebilling with a profile • Added silent post for prepaid cards • Added ThreatMetrix appendix. • Add optional delimiter for redirects and callbacks • Corrected rebill examples to include currencyCode • Added error message for updating a transaction • Added orderTimeout extended option and error message 1.2 May 2013 • Updated Return Keys appendix • Added Test and Production URLs section • Added section for updating an order • Removed Order/Response Examples appendix • Added section for rebilling • Added parameters to shipping details table • Added parameters to order status response table • Updated error response table • Added four appendices • Updated extended options key/value pairs table 1.1 March 20, 2013 • Added customer profiles • Added mobile functionality • Added return keys table • Added key/value pairs 1.0 January 1, 2013 Document release Optimal Payments Hosted Payments API Reference Guide 1.3.4 III December 2014 IV Contents 1 Hosted Payments API Overview . 1-1 API key. 1-1 URLs . 1-2 Test URL . 1-2 Production URL . 1-2 Workflow overview . 1-2 Mobile capability . 1-2 Operations supported. 1-3 Using this guide . 1-3 Audience . 1-3 Functionality. 1-3 Symbols . 1-3 Setting up an order. 1-4 Adding details to your order request . 1-5 Customer profiles . 1-5 Profile object example 1 . 1-6 Profile object example 2 . 1-6 Profile object example 3 . 1-7 Shopping cart information . 1-7 Ancillary fee information. 1-8 Billing detail information. 1-8 Shipping details . 1-9 Callbacks . 1-11 Redirects . 1-12 Links. 1-13 Payment methods. 1-14 Payment method notes . .1-15 Addendum data . 1-16 addendumData for MasterPass. 1-17 Localisation . 1-17 Finance plan. 1-18 Order response . 1-18 Making a payment . 1-20 Optimal Payments Hosted Payments API Reference Guide 1.3.4 V December 2014 Making a payment using a silent post . 1-21 Silent post for prepaid cards. 1-21 Silent post for credit cards . 1-22 Silent post for Giropay . 1-23 Silent post for iDEAL . 1-23 Silent post for NETELLER . 1-24 Silent post for Sofort Banking . .1-24 Silent post for Ukash . 1-24 Silent post for other supported payment methods . 1-24 Making a payment using customer profile . 1-25 Making a payment using a Hosted Payments customer profile . 1-25 Making a silent post payment using a customer profile . 1-26 Rebilling . 1-26 Rebilling with a profile . 1-27 Rebill request response. 1-27 Cancelling an order . 1-27 Cancel order response . ..