Socure ID+
Description
This REST service handles Socure ID+ Service requests.
Definition
POST /services/apexrest/intframework/v2/invokeIntegrationService
Authentication Type
Basic Salesforce Auth 2.0
See this link for SFDC Documentation: https://help.salesforce.com/articleView?id=remoteaccess_oauth_web_server_flow.htm&type=5
Parameters
Request Header Parameters
The following table provides the details of the request header parameters used by this web service:
Key | Value |
---|---|
Content-Type | application/JSON |
charset | UTF-8 |
Accept | application/JSON |
Request Body Parameters
The following table provides the details of the request body parameters used by this web service:
Field Name | Type |
---|---|
integrationFamily | String |
apiType | String |
executionPriority | String |
idsForFiltersMap | String |
borrowerId | String |
accountId | String |
optionalRequestParamsMap | String |
Error Messages
When you use this web service you can receive the possible error messages as shown in the following table:
Status Code | Error Message |
---|---|
400 | Bad request |
401 | Authorization information is missing or invalid |
404 | Not found |
500 | Internal server error |
Sample Request
The sample request that you receive is as shown in the following block:
{ "modules": [ "kyc", "fraud", "emailrisk", "phonerisk", "addressrisk", "watchliststandard", "alertlist", "decision" ], "physicalAddress2": null, "physicalAddress": "32194 N College Ave", "city": "New York City", "state": "NY", "zip": "10001", "dob": null, "nationalId": "598003289", "mobileNumber": "(201) 555-1234", "email": "test@gmail.com", "country": "US", "surName": "Smith", "firstName": "John"}
Sample Response
The sample response that you receive is as shown in the following block:
{ "referenceId": "a9f4401c-f85a-43af-b255-c4cfae2fc520", "nameAddressCorrelation": { "reasonCodes": [ "I709", "I708", "I710" ], "score": 0.99 }, "nameEmailCorrelation": { "reasonCodes": [ "I556", "I557", "I558" ], "score": 0.99 }, "namePhoneCorrelation": { "reasonCodes": [ "I621", "I622", "I618" ], "score": 0.99 }, "fraud": { "reasonCodes": [ "I553", "I121", "I127" ], "scores": [ { "name": "sigma", "version": "2.0", "score": 0.337 } ] }, "kyc": { "reasonCodes": [ "I919" ], "fieldValidations": { "firstName": 0.99, "surName": 0.99, "streetAddress": 0.99, "city": 0.99, "state": 0.99, "zip": 0.99, "mobileNumber": 0.99, "ssn": 0.99 } }, "addressRisk": { "reasonCodes": [ "I707", "I704", "I708" ], "score": 0.01 }, "emailRisk": { "reasonCodes": [ "I555", "I520", "I553" ], "score": 0.01 }, "phoneRisk": { "reasonCodes": [ "I614", "I616", "I605" ], "score": 0.01 }, "decision": { "value": "accept", "modelName": "Best Practice", "modelVersion": "4.0" }, "alertList": { "reasonCodes": [], "matches": [] }, "globalWatchlist": { "reasonCodes": [ "I196" ], "matches": {} } }
Usage/ How to Invoke
var borrowerId = "borrowerId=" + "{{contact_id}}"var accountId = "accountId=" + "{{account_id}}"var idsForFilters = []; idsForFilters.push(borrowerId); idsForFilters.push(accountId); var optionalReqParams = []; var requestParam = { integrationFamily: "KYC", apiType: "KYC-Fraud", executionPriority: "1", idsForFiltersMap: idsForFilters, optionalRequestParamsMap: optionalReqParams }; sforce.apex.execute('intframework.IntegrationWebServiceV2', 'runSynchronousIntegrationService', { requestParameters: JSON.stringify(requestParam) });