Make the Merchant Service Center available to app users

Many QuickBooks Online customers are merchants who process payments using QuickBooks Payments and the Merchant Service Center (MSC). The Merchant Service Center is a portal that lets them accept payments, manage statements, get reports, and complete other tasks.

You may want to point users to the Merchant Service Center and some it’s features from your app. Here are a few UI and feature ideas.

Step 1: Simply direct users to the Merchant Service Center

The MSC has a variety of payment tools. Include a link so users can sign in to the MSC and check out what’s available.

Step 2: Include Merchant Service Center features in your app

There are a few tools you can add for your users. What you build depends on the functionality you want to offer.


Integrate a simple charge interface

You can add a module that lets customers use the MSC’s charge features to process credit card payments from your app.

This example uses the following API entities:

You can design the UI however you’d like. Here’s a simple example:

../../../_images/Charge-flow-step-2.png

This example only lets users charge credit cards. Adding void and refund features requires a bit more work.


Send customers directly to the Merchant Service Center

If you don’t want to code void and refund features into your app, you can simply point customers to the MSC. Provide a link and tell them what to do once they signed in.


Include Merchant Service Center reporting features

Customers can create, download, and customize reports for their MSC statements. You can embed a link to MSC reports somewhere in your app’s patments workflow.

Step 3: Add additional Merchant Service Center features

Here are a few useful links you can include in your app to create a more complete merchant experience:

Note

Tip: If you’re using these examples for a sandbox or testing (PTC) environment, you’ll need to sign in with a test merchant account. Don’t use an active account or the one you use to sign in to QuickBooks Online company. Replace the Merchant Center endpoint (merchantcenter.intuit.com) with merchantcenter.ptcfe.intuit.com in the example links.
Send users to a specific transaction

Use the following: https://merchantcenter.intuit.com/portal/authsec/portal/qbms/Search+and+reporting/TransactionDetail?transactionId=XXXXXXX

Replace the XXXXXX with the transaction ID. This can be found in the server responses to requests to various QuickBooks Payments API entities.


Direct access to monthly account statements

Use the following: https://merchantcenter.intuit.com/msc/portal/combinedStmt


Change AVS/CSC settings

Users may want to check their preferences, or change the Address Verification System (AVS) or Card Security Code (CSC) settings for certain transactions. For instance, they may want to temporarily accept transactions, even without an entered address or card security code.

Keep in mind, even if users change this setting, the payment processor may still reject the transaction.

Use the following: https://merchantcenter.intuit.com/msc/portal/securitySettings