Check 21 Integration
  • 11 Oct 2022
  • 2 Minutes to read
  • Dark

Check 21 Integration

  • Dark

iOS Only

Currently, the Check 21 integration is only compatible with iOS Mobile Payments.


Blackthorn supports Check 21 integration by utilizing Check 21 technology into the Blackthorn Mobile Payments iOS app and the applications. It allows you to accept payments in the field by scanning checks.

Check 21, a third-party provider, will be leveraged through its API and native Salesforce package to achieve the check and money order processing.

Package Installs

  1. Install the latest version of Blackthorn Payments and complete the setup wizard.
  2. Install the Blackthorn Mobile Payments package and assign licenses to all users that need access.
  3. Install Check 21.
  4. Install the Check 21 Integration package.
  5. Assign MCC Payology permission set to the user.


Custom Settings Setup

  1. Navigate to Setup > Custom Settings > CheckForce API Custom Settings
  2. Click Manage.
  3. Click New.
  4. Enter the data listed in the following image.
    O_06_check 21 pic 1

Page Layout Updates

Update your Charge Transaction page layout to include four fields:

* Transaction Sub-Type
* Source
* Check Capture Submission
* Mobile Skip Intro Screen

The Transaction Sub-Type will be defined as "Check", Source will be defined as "Mobile", and Check Capture Submission will be populated after submitting a check through the mobile app.

Use Check Scanning Functionality from a Mobile App

  1. Open an existing Transaction from the Salesforce app that has the Amount populated, a Check 21 enabled Payment Gateway selected, and the Accepted Payment Methods = "Check".

  2. Click the Mobile Pay button at the top of the screen.
    O_06_check 21 pic 2

  3. You will be directed to a screen where you can scan the front and rear images of your check.
    Note: Setting Mobile Skip Intro Screen = "Yes" on the Transaction will take the user directly to the check scanning page. Otherwise, you will see a screen to validate the field values from the Transaction.
    O_06_check 21 pic 3

If Check 21 is not installed in the org, the user will not see the screen above.

  1. Tap on the left image to start scanning of the front of the check. It will ask for camera permissions, which you will need to accept, or the scan won’t be possible.

  2. Take a picture of the check. You'll notice a green rectangle appears. Line up the border with the check image. This rectangle will rotate with the screen orientation.

  3. Follow the directions above to capture an image of the back of the check.

  4. Once you have captured both the front and rear check images, the application will upload the images to the Check 21 API for image recognition.
    O_06_check 21 pic 4

  5. Verify the data from the images is correct, and click on Pay to finish the process.
    Note: You can edit the values detected by Check 21.

  6. The user will then be directed to a success screen where they can send an email receipt if needed.
    O_06_check 21 pic 5

  7. The Transaction Transaction Status field will be updated to "Completed".