Build Payment Support Tools

 

Clear platforms own the full user experience, including the first tier of support for payers and merchants. The WePay API enables you to build tooling for your support agents, such that you can quickly triage and resolve payment issues that may arise.

We require partners integrating the full Clear solution to own Tier 1 support. There are specific items which your team must be prepared to handle for end users, and the basic requirements and how-to's are outlined in this development guide, for both building it yourself, or leveraging the Partner Center.

These tools should be integrated into any existing tooling that your support team regularly uses to assist your user base with support questions from payers and merchants.

This guide will walk through how to build support tooling required for Clear integrations via our API, or how to use the Partner Center to achieve the same results.


Understand Requirements

Support tool components go hand in hand with merchant self-serve features. At its core, support tooling empowers your support team in assisting merchants with payments-related questions and tasks. Conversely, merchant self-serve features (listed here under item #4) empower merchants in getting the information they need without support intervention. As such, some requirements for your support tools can be met with the functionality provided in your merchant experience. All applicable items are listed under Conditionally Required Components. Additionally, the Partner Center can be leveraged to fulfill some support tooling components. Applicable requirements for which the Partner Center can be leveraged will be noted and outlined in the “Partner Center Method” sections.

Recommendations on building your support tool to complement Partner Center features will be provided as appropriate.


Required Components

ComponentSupportability ContextCustom MethodPartner Center Method
Update merchant email addressesMerchants may unexpectedly lose access to the email address, and your support team must be prepared to help them regain access to their account.
  • Look Up Merchants in a custom search tool
  • Collect new email address in a custom UI
  • Send an update Legal Entities request
  • Look up merchants in Partner Center
  • Collect the Account ID from Partner Center and then new email address in a custom UI
  • Send an update Legal Entities request
View PayoutsProvide statuses and any failure/pending reasons to assist merchants with receiving Payouts.
  • Look Up Merchants in a custom search tool
  • Decide whether to display Payouts on Account Details load or on another trigger
  • Send a GET /payouts request
  • Parse the results into a custom display for support agents
  • Click on Merchant Profile → Withdrawals to see Payouts.
View PaymentsProvide statuses and any failure/pending reasons to assist merchants and/or payers with processing Payments.
  • Look Up Merchants in a custom search tool
  • Decide whether to display Payments on Account Details load or on another trigger
  • Send a GET /payments request
  • Parse the results into a custom display
  • Look Up Merchants in the Partner Center
  • View Payments in the Partner Center Reporting tab.
Access Legal Entity VerificationsGuide merchants as to the kind of information and/or documentation to provide.
Provide merchants with the standard list of acceptable documents, then contact our support if more detail is needed.
  • Look Up Merchants in a custom search tool
  • Decide whether to display Verification on Account Details load or on another trigger
  • Send a GET Verifications request
  • Parse and display the results in a custom UI
  • Look Up Merchants in the Partner Center
  • Collect the Account ID from Partner Center in a custom UI
  • Send a GET Verifications request
  • Parse and display the results in a custom UI
Access Account CapabilitiesThere are strict regulatory requirements concerning KYC/CIP verification and account balances, and we communicate these by way of Account Capabilities and related current and upcoming issues. Your support team needs to guide merchants on required information, documentation, and deadlines.
  • Look Up Merchants in a custom search tool
  • Send a GET Capabilities request
  • Parse the results into a custom display for support agents
  • Look Up Merchants in Partner Center
  • Collect the Account ID from Partner Center in a custom UI
  • Send a GET Capabilities request
  • Parse the results into a custom display
Generate merchant reportsOftentimes, merchants may request assistance in reconciling their account. In order to offer this support, your team will need the ability to generate the same report the merchant receives. In addition, platforms which support Merchant IC+ should provide merchant billing statements to their support team.
  • Look Up Merchants in a custom search tool
  • Offer report generation and download UI triggers for Payouts and custom time-frames of the account history
  • For merchants on Merchant IC+ pricing, provide access to merchant billing statements
  • Look Up Merchants in the Partner Center
  • Customize and download reports
Visit the Partner Center Feature Guide to further inform your use of available features.

Conditionally Required Components

These components are vital to supporting payments on your platform. That said, if these functions are provided in your merchant self-serve features, then they are not required in your support tool.

ComponentSupportability ContextCustom MethodPartner Center Method
Issue refundsSituations may arise where a merchant is unable to issue a refund via the self-serve experience. Thus, we strongly recommend including this component in your support tool.
  • Look Up Payments in a custom search tool
  • Offer a Refund UI trigger for Payments which have not already been refunded or disputed, and are within the 60-day (or custom) refund limit.
  • Optionally collect amounts details for partial refunds
  • Send a POST /refunds request
  • Look Up Payments in the Partner Center
  • Collect the Payment ID from Partner Center in a custom UI
  • Optionally collect amounts details for partial refunds
  • Send a POST /refunds request
Update Payout periodsDue to our review process for payments and payouts, merchants may want a payout sooner than their next scheduled payout if they are on a weekly or monthly schedule. To provide the best customer experience, enable your team to make this change for merchants.
  • Look Up Merchants in a custom search tool
  • Offer an Update Payout Period UI trigger
  • Collect the new period
  • Send an Update Accounts request
  • Look Up Merchants in the Partner Center
  • Collect the Account ID from Partner Center in a custom UI
  • Collect the new period
  • Send an Update Accounts request

Prior to your launch with WePay, your platform will need to demonstrate that the above requirements are met.

You'll demonstrate your merchant self-serve first, at which point the requirements for your support tool will be determined on the above criteria.


Design Considerations

Gate Access

Many support teams have tiers based on experience, and more responsibility is granted the more experience a support team member has. As such, we recommend gating payment-related support tools as a security measure for your merchants and payers, and for your platform.

For instance, a newer member of a support team may not be familiar enough with your custom tools and policies to successfully look up the correct merchant account and update their payout period.

Mask WePay IDs

WePay API IDs are not intended for end-user consumption, though they are required in order to escalate support issues to WePay. As such, we recommend leveraging the reference_id parameter in the API wherever available (Accounts, Legal Entities, controller, additional representatives, payments, etc).

This will allow you to display your own IDs for transactions and such to end users, and to refer back to the WePay API object on the back end.

Additionally, your support team will need access to the WePay API IDs on occasion, but these IDs should be displayed such that any possible confusion with external-facing IDs is minimized. For instance, consider implementing a button in your support tool to fetch the WePay API ID of a given object.

For example, display your own IDs for Payments (which may also be used for reference_id in the WePay API):Example of using your reference ID to mask the WePay resource ID.
Example of using your reference ID to mask the WePay resource ID.

And reveal the WePay API ID on-click:

Example of how to unmask the WePay resource ID as needed.
Example of how to unmask the WePay resource ID as needed.