Directing Users to the Force.com Site

Direct Users to Utilize the Force.com Site

Directing Users to the Force.com Site

Developers can direct users from external sites to the Force.com public-facing Mobile Check Capture solution using the direct URL. However, some developers/clients may want to take advantage of the acceptable parameters which can be captured within the URL and are built into the solution. Such parameters will allow for the creation of a Check Capture Submission record with prefilled Lookups to a Salesforce Account ID, Contact ID, or User ID. Expected Amount validation can also be enabled through URL parameters.

Accepted Parameters in URL

ParameterDescriptionMapped Field
AccountSalesforce Account ID used if linking the Check Capture Record to one Salesforce Account ID.Maps to field "c21mcc_Account_c" in Check Capture Submission Record.
UserSalesforce User ID used if linking the Check Capture Record to one Salesforce User ID.Maps to field "c21mcc_Contact_c" in Check Capture Submission Record.
ContactSalesforce Contact ID used if linking the Check Capture Record to one Salesforce Contact ID.Maps to field "c21mcc_User_ID_c" in Check Capture Submission Record.
expectedAmountThe Expected Amount of the check. This is most commonly used if the check is linked to an invoice or policy (i.e. shopping cart amount) whose amount must match the user entered check amount.Maps to field "c21mcc_Expected_Amount_c" in Check Capture Submission Record.

Dynamic Parameters in URL

Dynamic Parameters are also accepted in the URL string. To use a dynamic parameter simply enter the Salesforce API name of the field in the URL.

https://<MCC_SITE>?c21mcc__Payer_Phone__c=9549898989

Data Capture in URL String

Developers who must capture additional data points such as invoice IDs, multiple records (i.e. multiple account IDs), or other data can do so by parsing the prefilled URL field in Salesforce.

ParameterDescriptionMapped Field
URLDataThis field will contain the all URL data to the right of the "?" within the URL string. This field can then be used to parse and create multiple related records within Salesforce.Maps to field "c21mcc_URLData_c" in Check Capture Submission Record.

Next Steps

With an understanding of the parameters that can now be used within the URL, users may want to explore the Check Capture User Interface. For a step-by-step guide of the user interface/experience, please see the next section, labeled Using the Force.com Check Capture Site.