Postback Results

Applies to: Direct | Capture

The /start endpoint public_data request object contains two postback properties:

  • results_url. Postback URL to handle response data from the verification process.
  • status_url. Capture Only. Postback URL to handle status updates for the Capture experience.

👍

Each response public_data object endpoint property value is postback.

Example results_url Postback Response

The following code block shows an example results_url postback response. The initial response is encoded as application/octet-stream. The example code block represents a decoded JSON object.

public_data: {
    "version": "3.7.1",  
    "endpoint": "postback"
},
private_data: {
    "transaction_id": "abcdefgh-ijkl-0123-mnop-1234qrstuvwx",
    "result": {
        "idcheck": {
            "data": {
                "docCategory": "DL",
                "stateIssuerMismatch": "No",
                "heightCentimeters": "160",
                "dLIDNumberFormatted": "G1111111",
                "state": "CA",
                "postalCode": "92101",
                "dateOfBirth": "01/01/1997",
                "isRealID": "No",
                "testCard": true,
                "weightKilograms": "50",
                "uniqueID": 9943,
                "restrictions": "",
                "dLIDNumberRaw": "G1111111",
                "endorsements": "",
                "address2": "",
                "organDonor": "No",
                "issueDate": "10/25/2015",
                "transactionIdentifier": "abcdefgh-ijkl-0123-mnop-1234qrstuvwx",
                "gender": "Female",
                "isDuplicate": "",
                "firstName": "Judy",
                "middleName": "Jane",
                "issuingJurisdictionAbbrv": "CA",
                "expired": "Yes",
                "docType": "",
                "expirationDate": "01/01/2020",
                "extendedResultCode": "Y",
                "lastName": "Doe",
                "duplicateDate": "",
                "issuingJurisdictionCvt": "California",
                "mediaType": "2D",
                "driverClass": "C",
                "address1": "2244 2nd Ave",
                "socialSecurity": "",
                "processResult": "DocumentProcessOK",
                "eyeColor": "Green",
                "weightPounds": "110",
                "heightFeetInches": "5' 3\"",
                "age": 27,
                "city": "San Diego",
                "hairColor": "Red"
            },
            "message": "",
            "success": true,
            "result": true
        },
        "OCR": {
            "data": {
                "weightKilograms": "50 kg",
                "errorMessage": null,
                "countryCode": "USA",
                "dlClass": "C",
                "address": "2244 2ND AVE\nSAN DIEGO, CA 92101",
                "documentNumber": " ",
                "eyeColor": "Green",
                "dateOfBirth": "1997-01-01",
                "dateOfBirthFormatted": "01/01/1997",
                "dlRestrictions": "NONE",
                "isRealID": "no",
                "sex": "F",
                "dateOfExpiry": "2020-01-01",
                "fullDocumentImageBase64": null,
                "age": null,
                "lastName": "DOE",
                "nationality": null,
                "height": "160 ",
                "firstName": "JUDY JANE",
                "dlEndorsement": "NONE",
                "faceImageBase64": null,
                "dateOfExpiryFormatted": "01/01/2020",
                "dateOfIssue": "2015-10-25",
                "placeOfBirth": null,
                "dateOfIssueFormatted": "10/25/2015",
                "fullName": "DOE JUDY JANE",
                "documentRecognized": 1,
                "issuerName": "California"
            },
            "success": true,
            "message": "",
            "result": true
        },
        "ipqs": {
            "addressDetails": {
                "data": {
                    "tor": false,
                    "transaction_details": {
                        "shipping_phone_line_type": "Unknown",
                        "valid_billing_address": false,
                        "risky_shipping_phone": null,
                        "shipping_phone_country_code": null,
                        "valid_shipping_address": null,
                        "leaked_billing_email": null,
                        "valid_billing_phone": null,
                        "fraudulent_behavior": false,
                        "billing_phone_line_type": "Unknown",
                        "phone_name_identity_match": "Unknown",
                        "phone_address_identity_match": "Unknown",
                        "risky_billing_phone": null,
                        "leaked_user_data": null,
                        "phone_email_identity_match": "Unknown",
                        "bin_country": null,
                        "billing_phone_carrier": null,
                        "bin_type": "N/A",
                        "billing_phone_country_code": null,
                        "valid_billing_email": null,
                        "shipping_phone_country": null,
                        "is_prepaid_card": null,
                        "risk_score": 76,
                        "user_activity": null,
                        "bin_bank_name": null,
                        "email_name_identity_match": "Unknown",
                        "valid_shipping_phone": null,
                        "valid_shipping_email": null,
                        "billing_phone_country": null,
                        "shipping_phone_carrier": null,
                        "risky_username": null,
                        "name_address_identity_match": "Mismatch",
                        "leaked_shipping_email": null,
                        "risk_factors": [
                            "Primary physical address is invalid."
                        ],
                        "address_email_identity_match": "Unknown"
                    },
                    "dynamic_connection": false,
                    "ISP": "Spectrum",
                    "region": "California",
                    "bot_status": false,
                    "host": "syn-012-345-678-999.res.spectrum.com",
                    "ASN": 12345,
                    "latitude": 32.60168313416717,
                    "security_scanner": false,
                    "city": "San Diego",
                    "trusted_network": false,
                    "zip_code": "N/A",
                    "organization": "Spectrum",
                    "recent_abuse": false,
                    "connection_type": "Residential",
                    "frequent_abuser": false,
                    "message": "Success",
                    "proxy": false,
                    "country_code": "US",
                    "active_tor": false,
                    "longitude": -117.06020614736126,
                    "shared_connection": false,
                    "fraud_score": 76,
                    "mobile": false,
                    "vpn": false,
                    "abuse_velocity": "none",
                    "active_vpn": false,
                    "success": true,
                    "high_risk_attacks": false,
                    "is_crawler": false,
                    "request_id": "R2d2C3poCB",
                    "timezone": "America/Los_Angeles"
                },
                "message": "",
                "result": true,
                "success": true
            },
            "fraudDetails": {
                "data": {
                    "device_id": "4f3a9b1c7d8e2f6a5b4c3d2e1f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5",
                    "is_crawler": false,
                    "organization": "Spectrum",
                    "active_vpn": false,
                    "request_id": "R2d2C3poCB",
                    "bot_status": false,
                    "brand": "N/A",
                    "last_seen": "2024-09-25 16:25:15",
                    "tor": false,
                    "city": "San Diego",
                    "latitude": 38.13,
                    "timezone": "America/Los_Angeles",
                    "model": "N/A",
                    "browser": "Chrome Mobile 128.0",
                    "active_tor": false,
                    "ip_address": "12.345.67.890",
                    "mobile": true,
                    "first_seen": "2024-09-25 16:25:15",
                    "proxy": false,
                    "isp": "Spectrum",
                    "unique": false,
                    "reasons": [
                        "User has do not track enabled",
                        "Abnormal browser settings detected",
                        "User is frequently changing devices",
                        "User is not unique"
                    ],
                    "longitude": -117.06020614736126,
                    "fraud_chance": 13,
                    "operating_system": "Android 10",
                    "recent_abuse": false,
                    "region": "California",
                    "connection_type": "Residential",
                    "country": "US",
                    "vpn": false
                },
                "result": true,
                "message": "",
                "success": true
            }
        }
    }
}


Process finished with exit code 0

Example status_url Postback Response

The following code block shows an example status_url postback response. The initial response is encoded as application/octet-stream. The example code block represents a decoded JSON object.

public_data: {
  "version": "3.7.1",
  "endpoint": "postback"
},
private_data: {
  "transaction_id": "abcdefgh-ijkl-0123-mnop-1234qrstuvwx",
  "status": [
    {
      "transaction_id": "abcdefgh-ijkl-0123-mnop-1234qrstuvwx",
      "customer_id": "0123456789",
      "client_time": "2024-09-25 21:01:56.576000",
      "server_time": "2024-09-25 21:01:57.472787",
      "event": 1001,
      "message": "URL: https://capture-sandbox.intellicheck.com/?token=abcdefgh-ijkl-0123-mnop-1234qrstuvwx&version=default&language=en-us",
      "sequence": "2024-09-25 21:01:56.576000",
      "timestamp": "2024-09-25 21:01:57.472787"
    },
    {
      "transaction_id": "abcdefgh-ijkl-0123-mnop-1234qrstuvwx",
      "customer_id": "0123456789",
      "client_time": "2024-09-25 21:01:56.577000",
      "server_time": "2024-09-25 21:01:57.471773",
      "event": 1002,
      "message": "UserAgent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/129.0.0.0 Safari/537.36",
      "sequence": "2024-09-25 21:01:56.577000",
      "timestamp": "2024-09-25 21:01:57.471773"
    },
    {
      "transaction_id": "abcdefgh-ijkl-0123-mnop-1234qrstuvwx",
      "customer_id": "0123456789",
      "client_time": "2024-09-25 21:01:56.577000",
      "server_time": "2024-09-25 21:01:57.398400",
      "event": 1105,
      "message": "/user/get-config API call made",
      "sequence": "2024-09-25 21:01:56.577000",
      "timestamp": "2024-09-25 21:01:57.398400"
    },
    {
      "transaction_id": "abcdefgh-ijkl-0123-mnop-1234qrstuvwx",
      "customer_id": "0123456789",
      "client_time": null,
      "server_time": "2024-09-25 21:01:56.754199",
      "event": 1142,
      "message": "Capture requirements include barcode",
      "sequence": null,
      "timestamp": "2024-09-25 21:01:56.754199"
    },
    {
      "transaction_id": "abcdefgh-ijkl-0123-mnop-1234qrstuvwx",
      "customer_id": "0123456789",
      "client_time": null,
      "server_time": "2024-09-25 21:01:56.301148",
      "event": 1140,
      "message": "Capture requirements include front",
      "sequence": null,
      "timestamp": "2024-09-25 21:01:56.301148"
    },
    {
      "transaction_id": "abcdefgh-ijkl-0123-mnop-1234qrstuvwx",
      "customer_id": "0123456789",
      "client_time": null,
      "server_time": "2024-09-25 21:01:47.609698",
      "event": 105,
      "message": "Transaction type: capture",
      "sequence": null,
      "timestamp": "2024-09-25 21:01:47.609698"
    },
    {
      "transaction_id": "abcdefgh-ijkl-0123-mnop-1234qrstuvwx",
      "customer_id": "0123456789",
      "client_time": null,
      "server_time": "2024-09-25 21:01:47.579333",
      "event": 505,
      "message": "Document type: na_dl",
      "sequence": null,
      "timestamp": "2024-09-25 21:01:47.579333"
    }
  ]
}