Custom Settings Configuration

Step 1: Configuration of the CheckForce API Custom Setting

Custom Settings

By generating and configuring the Payology Mobile Check Capture App's Custom Setting, the Salesforce Administrator can determine the messages displayed to users within the mobile check capture process, assign the license provided by Check21.com, enable debugging mode, select whether endorsement validation is required, and importantly enable amount and/or duplicate validation.

Generating a Custom Settings Record

To begin the generation process, the Salesforce Administrator must first navigate to the Custom Settings navigation item in Setup. To do so, please follow these steps:

  1. Click the Gear icon on the top right-hand corner of the window.
  2. Click "Setup".
  3. In the left-hand side input box type "Custom Setting".
  4. Click the navigation item labeled "Custom Settings".
  5. Find "CheckForce API Custom Settings".
  6. Click the "Manage" button to the left of the name.
  7. Click the "New" button.

Generating a Custom Settings Record

After being redirected to the new Custom Setting record, the Salesforce Administrator must provide the appropriate data points within the visible fields. Below is a grid describing the fields, recommendations, and requirements.

Field Name

Description

Recommendations

Required

Name

Name of Custom Setting

"API"

Yes

Activate Check Creation

Used to activate check record creation within Payology Select or Payology Prime.

False

No

API Content

In future versions, additional authorization data points will be required.

Blank

No

API Key

In future versions, additional authorization data points will be required.

Blank

No

Check Endorsement Validation

Used to determine whether the rear check image has an endorsement. This function directly impacts performance of the check capture process. Unless the receiver and check payer are the same person or organization, this function should not be used.

False

No

Redirect Link

If using Community Cloud or Force.com components, this link will be utilized on completion of the check capture process, redirecting the user to the provided website. This field supports tokens (i.e. passing the Check Capture Submission record)

The Check21.com team recommends using these tokens within this link to capture the generated capture record ID.

If redirecting a user to an external site on check capture completion, this field is required. Otherwise, no.

MCC Duplication Validation

If enabled, all checks captured using the App will be analyzed to determine whether they have been captured previously. If so, the check capture status will change to "Duplicated".

The Check21.com team recommends enabling this function.

No

Expected Amount Validation

If enabled, the check amount entered by the user during the capture process will be compared to the amount provided within the "expected amount" field in the check capture record. The check capture status will change to "Expected Amount Does Not Match" if the two amounts do not match.

If underpayments or over-payments are not allowed, the Check21.com team recommends enabling this function.

No

Log Transaction

If enabled, the debugging process will be added to the check capture workflow. For each check image captured, a debug file will be generated and related to the capture record.

If developers or end-customers encounter issues in the check capture process, the Check21.com team recommends enabling this function temporarily.

No

Mobile License Number

Mobile or Scanner Endpoint license number provided by the Check21.com team.

License Number

Yes

Use Mobile License Number

If enabled, all check images captured will be submitted to the Mobile Endpoint. Otherwise, they will be submitted to the Scanner Endpoint.

The Check21.com team recommends enabling this function if capturing images through a mobile device. If using a flatbed scanner, please disable this function.

No

OCR License Number

OCR Endpoint license number provided by the Check21.com team.

License Number

If enabling Validate Endorsement function, this license number is required. Otherwise, it may be left blank.

Amount Validation Message

Error message displayed if user entered amount is not greater than "$0.00".

"Please enter an amount greater than $0.00."

If using the Community Cloud or the Force.com functions, this field is required. Otherwise, it may be left blank.

Missing Data Message

Error message displayed if user clicks "next" without capturing an image or entering an amount.

Please snap a photo of your check, enter the amount, and click next.

If using the Community Cloud or the Force.com functions, this field is required. Otherwise, it may be left blank.

Front Image Submission Error Message

Error message displayed if front check image submitted fails to process correctly.

The check could not be processed, please retry.

If using the Community Cloud or the Force.com functions, this field is required. Otherwise, it may be left blank.

Front Image
Missing Message

Error message displayed if rear image of check is submitted prior to the front check image.

The front image of the check is required.

If using the Community Cloud or the Force.com functions, this field is required. Otherwise, it may be left blank.

Processing Image Message

Error message displayed if rear image of check is submitted prior to the completion of the front check image processing.

Please wait while we process this check and try clicking next again.

If using the Community Cloud or the Force.com functions, this field is required. Otherwise, it may be left blank.

Rear Image Missing Message

Error message is displayed if user entered amount is greater than $0.00, front check image has been processed successfully and user clicked "next" without capturing the rear check image.

The rear image of the check is required.

If using the Community Cloud or the Force.com functions, this field is required. Otherwise, it may be left blank.

Record ID Insert Failed Message

Error message displayed if Check Capture Submission record failed to create in Salesforce.

An error has occurred. Please retry submitting your check or call customer support if you continue to encounter issues.

If using the Community Cloud or the Force.com functions, this field is required. Otherwise, it may be left blank.

Invalid Account Failed Message

Error message is displayed if an Account ID was provided within the parameter of the URL but does not exist in Salesforce.

Account ID provided invalid.

If using the Community Cloud or the Force.com functions, this field is required. Otherwise, it may be left blank.

Invalid Contact Failed Message

Error message is displayed if an Contact ID was provided within the parameter of the URL but does not exist in Salesforce.

Contact ID provided invalid.

If using the Community Cloud or the Force.com functions, this field is required. Otherwise, it may be left blank.

Invalid User Failed Message

Error message is displayed if an User ID was provided within the parameter of the URL but does not exist in Salesforce.

User ID Provided invalid.

If using the Community Cloud or the Force.com functions, this field is required. Otherwise, it may be left blank.

Home Page
Message

Message shown within the first step of the Check Capture UI.

All payments submitted before 9PM EST will be settled the same business day.

If using the Community Cloud or the Force.com functions, this field is required. Otherwise, it may be left blank.

Front Image Missing Message

Error message displayed if rear image of check is submitted prior to the front check image.

Please snap a photo of the front of the check before attempting to capture the rear image of the check.

If using the Community Cloud or the Force.com functions, this field is required. Otherwise, it may be left blank.

Check Capture Resubmit Message

Error message displayed if check image capture process fails.

Unfortunately, we could not properly capture the check image. Please resubmit the check again.

If using the Community Cloud or the Force.com functions, this field is required. Otherwise, it may be left blank.

Duplicated Error Message

Error message displayed if user entered/confirmed check data matches previously captured data/records.

Duplicated check

If using the Community Cloud or the Force.com functions, this field is required. Otherwise, it may be left blank.

Incorrect Exp Amount Message

Error message displayed if user entered/confirmed amount does not match the expected amount (field on check capture submission record).

The typed amount is not the expected amount

If using the Community Cloud or the Force.com functions, this field is required. Otherwise, it may be left blank.

Upload Success Message

Text message will be shown to the user when the image is uploaded with success.

Upload with success!

If using the Community Cloud or the Force.com functions, this field is required. Otherwise, it may be left blank.

Payment Method Object

Out-of-Package Object/Record which will be created upon successful Check Capture Submission Record update.

If using Payology Prime PayPrimePayment_MethodC
If using Payology Lite it is payliteCheckc

No

Payment Allocation Object

Out-of-Package Object/Record which will point to Allocations of the Check, it's not created automatically.

If using Payology Prime PayPrimePayment_Allocationc
If using Payology Lite it is payliteCheck_Allocationc

No

Payment Check Submission ID

Out-of-Package Object/Record, it is the name of the field that will create a Relationship between Payology Mobile Check Capture and Check Object

This field need to be created manually and the API name need to be set here

No

Next Steps

To continue the configuration process, Salesforce Administrators or Developers must understand the Redirect URL tokenization process (when not using Native Mobile Apps). For detailed information on the token usage, please see the next section, labeled Using Tokens in URL Parameters.