ePay

Creating your Merchant Account

Before you can set up the ePay feature in CCH iFirm, you must create a merchant account with a payment services provider (PSP). CCH iFirm integrates with the following PSP:

• Braintree, a PayPal service. Sign up for a Braintree account at https://www.braintreepayments.com.

• CPACharge, an AffiniPay solution. Sign up for a CPACharge account at https://www.cpacharge.com.

• Stripe. Sign up for a Stripe account at https://stripe.com/en-ca.

When you set up your merchant account, note the following information if it is provided:

• Merchant ID

• Public (publishable) API key

• Private (secret) API key

• Username/password

Important: Almost all Canadian credit cards issuers require CVV verification to process transactions on their network. Therefore, you must ensure that the Card Verification toggle button is enabled in Braintree. Card verification is a strong first line defense against potentially fraudulent cards. It ensures that the credit card number provided is associated with a valid, open account and can be stored in the Braintree Vault and charged successfully. Braintree can verify the following with the customer’s bank: the card number, card expiration date, street address and postal code. For more information, consult the following Knowledge base article: https://support.cch.com/canada/solution/000122561/Errors-processing-payment-via-ePay?language=en.

After setting up your merchant account, follow the instructions in Configuring ePay Options in CCH iFirm.

Back to top

Configuring ePay Options in CCH iFirm

After you created a merchant account, use the following procedure to configure the ePay options in CCH iFirm. This process includes:

• Entering information provided by the payment services provider (such as the merchant ID, public API key and private API key, private API key, username and password).
• Customizing the payments page that customers see when they click a payment link.
• Entering the contact information that customers can use to contact the firm with billing questions.

To configure the ePay options, proceed as follows:

1. Got to Settings > Firm Settings > ePay.
2. Select Allow ePay on invoices.
3. Click Configure.
4. With the PSP Details tab selected, click Settings for your PSP.
5. Complete the set up for your PSP.
   1. PayPal (Braintree)
      1. Enter your Merchant ID, Public API key and Private API key. This information is provided by Braintree.
      2. If needed, clear the Sandbox account check box.
      3. Click Verify.
      4. Click Submit.
      5. If you have billing sub-accounts, verify that the default sub-account is selected.

   2. CPACharge

      1. Click Authorize.

      2. You will be prompted to enter your CPACharge username and password.

      3. Click Authorize.

      4. Click Submit.

   3. Stripe

      1. Enter your publishable API key and secret API key. This information is provided by Stripe.
         If needed, clear the Test mode check box.

      2. Click Verify.

      3. Click Submit.

   Important: If your firm uses a testing environment or sandbox account, make sure to clear the Sandbox account or the Test account check box before sending ePay links to your customers.
6. Click Merchant Setup.
7. On the Display Name tab, do the following, as applicable:
   • Add a logo. A logo is not required. If you add one, it displays next to the firm name on the payment page.

   1. Click Browse next to the Upload new logo image box.
   2. Navigate to and select the logo image file.
   3. For optimal display on both large and small screens, your logo should be no larger than 350 pixels by 120 pixels.

   • Change how your firm name displays. By default, the Display name field is populated with your firm's name. You can modify the text and use the text formatting tools to change its appearance on the payment page.
8. Click the Contact Information tab.
9. Enter the contact information that should be used by your clients to contact your firm if they have questions about their invoice.
   
   Note: A message containing this contact information will display if a client encounters an issue using the ePay system. If nothing is entered there, the message will instead instruct the client to contact the firm, with no contact information.
10. Click Submit.

Back to top

Setting a Payment Provider as Default

If you have multiple payment provider accounts set up, you can select one payment provider as the default option. To do this:

1. Go to Settings > Firm Settings > ePay.
2. Select Allow ePay on invoices.
3. Click Configure.
4. Click Settings next to the provider you would like to be the default option.
5. Click Make default.

Invoices sent from your firm will use the default payment provider in most cases.

Back to top

Payment Options

The following payment options currently work with CCH iFirm:

• Credit cards (Braintree, Stripe, CPACharge)
• Google Pay (Stripe)
• Apple Pay (Stripe)
• Pre-authorized debits (Stripe)

Back to top

Payment Failures

Stripe

If there is an error when the customer is trying to pay an invoice, this will not be reflected in the Accounts Receivable in CCH iFirm. Only successful payments will be reflected.

CPACharge and Braintree

If there is an error when the customer is trying to pay an invoice, this will be reflected in the Accounts Receivable for that client as a “0.00” entry, which will prevent you from unfinalizing the invoice.

Back to top

Pre-authorized debit payments

Stripe

When a customer pays an invoice using pre-authorized debit in Canada, the payment will be Pending in the Accounts Receivable Transaction and Finalized Invoices lists. Once the payment has been cleared by the customer’s financial institution, the status will be updated to Succeeded. If the payment fails, the status will be updated to Failed. The failed payment will be released, and the customer will then be able to submit a new payment with the original invoice link.

Finalized Invoices

Account Receivable Transactions

Back to top