Configuration: Payment Gateway - Braintree

Setup Checklist

This section is a comprehensive and high level summary of all tasks and prerequisites required for this feature to function properly. This section is purposed for use after an administrator is familiar with configuring this feature as an “audit” checklist. For detailed set-up instructions, jump down to “Prerequisite Tasks” and “Detailed Setup Guide” and then follow up with this checklist to ensure all steps are completed.

Detailed Setup Guide

This section describes all required steps to set up the feature after prerequisite tasks have been completed.

POS Tasks

• Complete POS accounting tasks for products sold online.

Payment Provider Tasks

Determine which additional payment methods will be supported for your resort. Possibilities include:

• PayPal

• Apple Pay

• Google Pay

Option 1: Configure Google Pay in Braintree

• Use debug merchant ID for test: 01234567890123456789

• In production Braintree go to Settings > Processing > Google Pay and enable Google Pay. 

• You'll also need to submit a support request with Google to register your domain and receive a merchant ID. - fill out this form.

• Send Aspenware test site and production site to Google

• Google approves submissions for APIs. They will need to ensure it adheres to their Acceptable Use Policy

• Once approved, you’ll send Google an email address to be used for production access.

• Once they approve you, you can sign up for a developer account HERE.

• Send Aspenware your merchant ID.

Option 2: Configure Apple Pay in Braintree

• Set up an Apple Developer Account and Merchant and Certificate and upload your Certificate in Braintree.

• Download the Certificate Signing Request.

• Sign in to your Developer Center in Safari. (You may need an Apple Developer Account to do this.)

• Create an Apple Pay Merchant ID - You'll first need a developer center account to do this. They recommend using separate Apple Pay Merchant IDs for sandbox and production to ensure that your sandbox app cannot create production transactions.

• Generate a new Apple Pay Certificate in Apple's developer portal - again you'll do this within your developer center.

• in Braintree production, Select Apple Pay Certificate and click Continue.

• In the drop-down, choose the appropriate Apple Merchant ID for your Braintree environment (Sandbox or Production) and click Continue.

• Under Payment Processing Certificate, click Create Certificate.

• Upload the CSR that you downloaded from Braintree in the first step above. You must use the CSR we provide. Do not create a CSR file yourself.

• Download the new Apple Pay Certificate and upload it when setting up Apple Pay in Braintree go to Settings > Processing > Apple Pay

• Then host the domain association file from Apple on the shop.

Aspenware Commerce Tasks

1. Update Settings

2. Set up GL Report.

3. Configure Aspenware Commerce Payment Gateway

1. Update Settings

NOTE: You will need to determine if you will be using Aspenware Payment Plans with your Braintree implementation before updating the following settings.

• Go to Configuration > Settings > All settings (advanced)

  1. Search for ecommercesettings.allowtransferofcc

     

      

     1. Click Edit.

        

         

     2. Set the Value to FALSE and click Update.

        

  2. Search for ecommercesettings.allowstorageofcc

     

      

     1. Click Edit.

        

         

     2. Set the Value as follows:

        1. If Using Aspenware Payment Plans, set to FALSE

        2. If NOT using Aspenware Payment plans, set to TRUE

           

     3. Click Update.

2. Set up GL Report

• Work with your Aspenware Representative to set up the GL Report so you can reconcile GL reporting in the POS and payment gateway.

3. Configure Aspenware Commerce Payment Gateway

• Go to Configuration > Payment Methods in Admin.

• Click Edit on the Braintree payment gateway.

• Check Is active the for Braintree and Save.  Ensure that only Braintree is set to Is active.

• Select Configure on the Braintree payment method. 

• To change or set up payment account, fill in the following fields:

  • Use Sandbox: Should be checked for test and unchecked for prod

  • Merchant ID: Obtain from Braintree

  • Private Key:  Obtain from Braintree

  • Public Key: Obtain from Braintree

  • Additional Fee: Set to 0.00

  • Additional fee. Use percentage: Unchecked

  • Requires Billing Address: Unchecked

  • Requires Phone Number: Unchecked
    

    

• Click Save.

• Test a live credit card for each type of accepted credit card (Visa, Amex, Discover, Mastercard) to ensure the gateway is processing payments properly once setup is completed. 

Common Troubleshooting

Q: What functionality is and isn’t available to me because of having Braintree as a Payment Provider?

A: Good news is that using Braintree allows you to enable a number of advanced features, most notably Payment Plans, Saving a credit card to use on future e-commerce transactions, Apple Pay, Google Pay and Pay Pal. Some limitations with using Braintree are that in order to store a token for being charged at a later date, a minimum $1 transaction must be completed to store the card, so any product that enrolls you in a Payment Plan must have a minimum $1 deposit. Unfortunately, because some functionality is made possible by having a token stored in the POS, and neither RTP|One nor Siriusware support storing Braintree tokens, resort charge, direct to lift, and capturing tokens for refunds in the POS is not supported.

Q: When I look at an order status in Aspenware Commerce Order Details, the status is set to pending rather than complete? What’s wrong with this order?

A:  The true indicator of whether a product made it to RTP|One successfully is the order queue. If you see orders showing as ‘Pending’ in the Sales > Orders area, check if any products in these orders have Shipping checked on the product editor.

This won't cause problems per se but is really only used for retail products that are shipped, so it shouldn't be checked.  Because nopCommerce is often used as a retail platform, what processing means in Nop is similar to what Open means in RTP|One. The order is paid for, but the order has not been fulfilled, aka shipped. For ski, we send the order to RTP|One for fulfillment and don't do any fulfillment in NOP - we use the delivery plugin for shipping ski media and ignore nopCommerce shipping, so it's not a problem, but my guess is that if you uncheck shipping on these products and save it, you will start seeing these orders show as completed.