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.
31913191

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 NameDescriptionRecommendationsRequired
NameName of Custom Setting"API"Yes
Activate Check CreationUsed to activate check record creation within Payology Select or Payology Prime.FalseNo
API ContentIn future versions, additional authorization data points will be required.BlankNo
API KeyIn future versions, additional authorization data points will be required.BlankNo
Check Endorsement ValidationUsed 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.FalseNo
Redirect LinkIf 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 ValidationIf 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 ValidationIf 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 TransactionIf 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 NumberMobile or Scanner Endpoint license number provided by the Check21.com team.License NumberYes
Use Mobile License NumberIf 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 NumberOCR Endpoint license number provided by the Check21.com team.License NumberIf enabling Validate Endorsement function, this license number is required. Otherwise, it may be left blank.
Amount Validation MessageError 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 MessageError 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 MessageError 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 MessageError 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 MessageError 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 MessageError 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 MessageError 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 MessageError 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 MessageError 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 MessageError 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 MessageError 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 MessageError message displayed if user entered/confirmed check data matches previously captured data/records.Duplicated checkIf using the Community Cloud or the Force.com functions, this field is required. Otherwise, it may be left blank.
Incorrect Exp Amount MessageError 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 amountIf using the Community Cloud or the Force.com functions, this field is required. Otherwise, it may be left blank.
Upload Success MessageText 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 ObjectOut-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 ObjectOut-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 IDOut-of-Package Object/Record, it is the name of the field that will create a Relationship between Payology Mobile Check Capture and Check ObjectThis field need to be created manually and the API name need to be set hereNo

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.