Chase Pay What’S New
Total Page:16
File Type:pdf, Size:1020Kb
Chase Pay What’s New CHASE PAY E-commerce Implementation Specification December 2017 Document Version 3.41 Page 1 of 85 Chase Pay What’s New Chase Pay® E-commerce Implementation Specification Version 3.41 December 2017 Copyright © 2017 JPMorgan Chase & Co. All rights reserved. All Information contained herein is STRICTLY CONFIDENTIAL AND PROPRIETARY – Not for Use or Disclosure outside JPMorgan Chase Bank N.A., and its respective affiliates or customers. This publication is for informational purposes only, and its content does not represent a contract or agreement, in any form. Chase reserves the right to alter product specifications without notice. No part of this publication may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopy, recording, or any information storage or retrieval system, without Chase’s permission. All brand names and product names used in this document are trade names, service marks, or registered trademarks of their respective owners. No part of this publication shall be construed as any license, express or implied, to any of the respective owners’ trade names, service marks or trademarks or any patents, copyrights or other intellectual property of JPMorgan Chase Bank, N.A., and its respective affiliates and shall not be used or furnished as any reference and/or in connection with any advertisement, announcement, release or promotional materials by any persons other than such respective owners. Page 2 of 85 Chase Pay What’s New What’s New Changes from previous version 3.31 and 3.4 are the following: About this Specification section is re-written References sub-section is re-written Getting Help sub-section is re-written Payment Flows are replaced Chapter 2 is completely re-written API Attributes are updated Error Handling Table is inserted at end of Chapter 4 Page 3 of 85 Chase Pay What’s New Table of Contents What’s New ............................................................................................... 3 About This Specification ............................................................................ 7 Audience ................................................................................................. 7 References .............................................................................................. 7 Getting Help ............................................................................................ 7 Abbreviations & Terminology ...................................................................... 7 Chapter 1 Getting Started ......................................................................... 8 Chase Pay E-commerce Process flow ........................................................... 9 Before Proceeding..................................................................................... 9 Tokenization is key ................................................................................. 9 Branding guidelines .............................................................................. 10 Chapter 2 Wallet Frontend Integration ................................................... 12 Introduction ........................................................................................ 12 Step 1: Add the Chase Pay JavaScript Element ........................................ 12 JavaScript URLs ................................................................................. 12 API Implementation Options ............................................................... 13 Step 2: Register JavaScript callbacks for Chase Pay events ....................... 13 Step 3: Configure Lightbox Functionality ................................................ 16 Step 4: Insert and Customize Chase Pay Buttons or Branding Elements ...... 17 Implementation Options ..................................................................... 17 Option 2: Inserting a Branding Element (mutually exclusive selection option) 18 Chase Pay Iconography Customization Options...................................... 19 Step 5: Insert the “Learn More” Link ...................................................... 23 API 24 Payment Completion .......................................................................... 26 Putting it All Together: Full Examples ..................................................... 26 Chapter 3 Wallet Backend Integration .................................................... 34 Getting Started ...................................................................................... 34 Communication Protocol ..................................................................... 35 SSL Implementation .......................................................................... 35 Posting to a URL ................................................................................ 35 Page 4 of 85 Chase Pay What’s New Interfaces ......................................................................................... 35 Web Services .................................................................................... 36 Chase Pay Service WSDL files - Certification ......................................... 36 Chase Pay Service WSDL files – Production ........................................... 36 SOAP Message Style and Encoding....................................................... 36 XML Service ...................................................................................... 36 MIME Header .................................................................................... 37 Common to both SOAP and XML Service ............................................... 37 Connectivity ........................................................................................... 38 Internet Connection ........................................................................... 38 MPLS/VPN Connection ........................................................................ 38 Managing Failover .................................................................................. 39 Orbital Authentication ............................................................................. 39 Credentials Hierarchy Options .................................................................. 40 Chapter 4 API Calls and Payment Data Retrieval ..................................... 43 SOAP Web Service Implementation ........................................................... 44 MerchantSession Data Message - SOAP .................................................. 44 GetCheckout Data Message - SOAP ........................................................ 51 SOAP Fault Element ............................................................................. 59 Example ........................................................................................... 59 XML Implementation ............................................................................... 60 MerchantSession Data Message – XML .................................................... 60 GetCheckout Data Message - XML .......................................................... 68 Error Handling ........................................................................................ 76 Putting it All Together – From Using the Chase Pay Button to Transaction Mapping .............................................................................................. 78 Chapter 5 Digital Account Management in the Chase Pay Wallet ............. 80 Chapter 6 Handling Chase Pay Transactions ............................................ 81 Purchase Transactions ............................................................................. 81 Purchase Cancellation ............................................................................. 81 Returns and Refunds ............................................................................... 81 Split Tender ........................................................................................... 81 Split Shipments ...................................................................................... 81 Recurring Payments ................................................................................ 82 Disputes & Chargebacks .......................................................................... 82 Page 5 of 85 Chase Pay What’s New Handling Returns .................................................................................... 82 Chapter 7 Certification ............................................................................ 84 Chapter 8 Other Resources...................................................................... 85 Page 6 of 85 Chase Pay About This Specification About This Specification This specification provides steps on implementing Chase Pay in an E-Commerce environment. NOTE: Provide any feedback on this document to your assigned Chase Account Executive. Audience This specification is intended for use by Merchants and internal Chase support personnel assisting in a Chase Pay implementation effort in an E-Commerce environment. Merchants using this specification must also have an acquiring relationship with Chase Merchant Services. References Use the Chase Pay – CMCP Documents Index provided by your Chase Account Executive or Chase Technical Implementations Manager for a list of documents needed depending on the type of Chase Pay Implementation. Getting Help A Chase Pay Technical Implementations Manager is available to assist Merchants in any Chase Pay implementation. Consult with your Chase Account Executive for more information. Abbreviations & Terminology