Versions Compared

Version Old Version 4 New Version 5
Changes made by

Cecilia Do

Cecilia Do

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Preparation / Setup

uPay

  1. Email Address -
    1. Initiate the request for the email address to be entered on the production uPay sites; this address is the “From” address on the email receipt for users that enter their email address on the credit card payment form, as well as receive alerts for failed transactions, etc.
    2. Your own email address can be used for testing, but the production site needs the official functional office email address that will be monitored.
  2. Graphics -
    1. Initiate the request for images for the header, sidebar (optional), and footer of the uPay screens
    2. These are not needed for testing, but must be ready for production
  3. Style Sheet -
    1. The look of the uPay site can be modified by uploading customized style sheets. This is optional. If you want to use them, initiate the process to develop and approve the design of your production uPay site.

uPay Postback Setup

  1. Submit TEST and PROD department postback IP/port information to sfinsvcsdev@uci.edu 
    1. TouchNet needs to be notified to add firewall exception to allow postback transmission through
    2. Port needs to be an SSL port (i.e. 443, 8443)

...

  1. Marketplace - uPay Site Manager
    1. This allows you to modify the uPay Site that will be initialized for you in PRODUCTION
    2. Note that in TEST, you will be creating your own from scratch
    3. This is minimally the developer for this project, additional functional staff may be added to this role in the future
  2. Marketplace - uPay Payment Clerk
    1. As a developer, when it’s time to test the PRODUCTION uPay site, you will need a real credit card and perform a live transaction. You will want to be able to refund this charge immediately after; in production this is a FUNCTIONAL USER role, developers only use this feature for testing
  3. Marketplace - uPay Accountant
    1. This is solely a functional user role

 

 

uPay Integration

  1. Department Storefront / Sending Web Application – - until you set up your sending web application, you can use the above “uPay "uPay Test URL” to check your uPay site configuration
    1. UPAY_SITE_ID – required
      1. Required;
       
      1. when you create your uPay Site, it will generate a Site ID value that you must send with the customer to TouchNet
    2. EXT_TRANS_ID – strongly suggested; 
      1. Strongly recommended; you must send this key/value to get a reference value in the postback to know what/who this payment is for, like for which invoice number this payment applies to
    3. EXT_TRANS_ID_LABEL – this is optional, this
      1. Optional; allows you to label this value for the customer in a way that is relevant
      Code Block
      <input type="hidden" name="UPAY_SITE_ID" value="$upay_site_id">

      
<input type="hidden" name="EXT_TRANS_ID_LABEL" value="$ext_trans_id_label">

      
<input type="hidden" name="EXT_TRANS_ID" value="$ext_trans_id">
  2. Postback Web Application – - you must decide if you will use a separate web application to process the postback results of the payment transaction;   you will need to test the postback functionality of the payments submitted
  3. Create your TouchNet uPay Site in the TEST version;   fill in the information for the following sections;   specific fields mentioned are not inclusive of all the fields you need to enter, just those with hints to help your development:
    1. Miscellaneous
      1.                                                                i.       Site Name – - Make it reader friendly;   this will show in the signature block of the notification of payment email the user receives;   must also be identical to the Program Name in the ECommerce profile
      2.                                                              ii.       Posting URL – - is the web application that TouchNet will send the postback payment results to;  it it does not have to the same URL as your original web application used for sending the client to TouchNet;   make sure any necessary firewalls rules are in place to allow TouchNet to access this web application
      3.                                                             iii.       Additional Posting Value – - not viewed by anyone but your postback application and is meant to allow you to validate the source of postback html POST
      4.                                                            iv.       Success Link URL – - button; where customers go after their payment has completed
      5.                                                              v.       Error Link URL – - only used for system errors
      6.                                                            vi.       Cancel Link URL – - button; where customers go when they click the cancel button
    2. Messages & Titles
    3. Payment Settings
      1.                                                                i.       Required encoded validation key for amount – - If you are using a default payment amount, you do not need to enable this
      2.                                                              ii.       Passed Amount Validation Key – - If you are using a default payment amount, you do not need to populate this
      3.                                                             iii.       Default Payment Amount – - If you are using a default payment amount, you MUST enter a that value here (no dollar signs, e.g.,   100.00)
      4.                                                            iv.       Payment Amount Prompt – - If you are using default payment amount, this prompt is not displayed anywhere
    4. Images – - Upload your header, footer, and sidebar (optional) images here;   you can test your payments without this at the beginning
    5. Style Sheets – - Optional, upload your style sheets here if you’re using them
    6. Users – - Do not edit anything here

...

  1. Change the status of your new uPay Site to “Enabled” – - this is changed in the Miscellaneous section
  2. Use the uPay Test URL above to test your uPay set up
  3. Test MC credit card number:
         MasterCard 5454545454545454
         CVV 125
         Any future expiration
    1. Review the posted payments in TouchNet by navigating to the Payment Search
      1. Search for your payment, usually by “Order Date” range
      2. Verify results
  4. Test your sending web application – - set the form action value to the “uPay Posting URL” above
  5. Test your postback processing – - you will bet back an assortment of key/value pairs depending upon your uPay Site configuration
  6. Once your end-to-end testing is successful, you are ready to move to setting up the production environment
  7. Submit your Ecommerce program for your uPay Site;   if you have multiple uPay sites, you will need a separate program for each site
    1. https://applications.oit.uci.edu/ecommerce/
    2. IMPORTANT:   The “Program Name” must be identical to the “uPay Site Name”
    3. IMPORTANT:   The uPay Site Name is used in the payment notification email in the signature block, e.g., “Sincerely, (uPay site name)” so consider how a cryptic name will look in the signature block
  8. Your production uPay sites will be initialized for you with the Site Name and some minimal settings;   enter additional customized settings as needed (Site Email Address, images, style sheets, verbiage for messages and emails, etc.)
    1. Follow the instructions provided in the uPay Reference Guide wiki page
  9. Change your site status to “Enabled”
  10. You can continue to use your web applications in test mode while accessing the production uPay Site but any payments submitted require a real credit card creating real charges;   be sure you have the ability to refund your transactions
  11. Change all settings to production and run final end-to-end testing in the production environment
  12. Remind the functional unit to set up their staff with individuals that can process refunds and access the accounting features in TouchNet
  13. Submit SAQ-A and Terms and Conditions forms to the functional department head for signature and submission to Dianne Bean

...