cs-security-experience-api-services icon

cs-security-experience-api-services

2.4.x
(0 reviews)
This API provides identity validation, OTP management, survey generation, token handling for portals, and blacklist verification across multiple versions to ensure secure authentication and data processing

🏠 Home - 🛡️cs-security-experience-api-services

This API offers robust identity and security validation services. It includes endpoints for:

  • Identity and phone verification
  • One-Time Password (OTP) operations
  • Security surveys and token management
  • Integration with Experian, Inspektor, Fasecolda, Registraduría, Ariba, TransUnion
  • Evaluation of restrictive lists and authentication assessments

All services are exposed through organized versions (v1, v3, v4) and provide secure access to backend validations.

🌐 Base Information

  • API Title: cs-security-experience-api-services
  • Version: 1.0.0
  • Base URL: https://security-experience-api-prod.us-e1.cloudhub.io/api

🚀 Getting Started

  1. Authentication: Ensure you have the required client_id and OAuth 2.0 Bearer token for secure access.
  2. Base URL: Use the provided Base URL as the prefix for all API endpoints.
  3. Headers: Add the following headers in your API requests:-H "client_id: YOUR_CLIENT_ID" -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

🚀 How to Consume

You can access and consume this API through the following platforms:

📍 Available Endpoints

📌 Endpoints Overview

MethodEndpointDescriptionExchange Link
POST/customer/v1/identity/validateValidates customer identity.View details
POST/security/v1/OTP/initializeSends OTP to customer's device.View details
POST/security/v1/OTP/validateValidates customer's OTP input.View details
POST/security/v1/survey/generateCreates a security survey for customer.View details
POST/security/v1/survey/validateValidates customer's survey responses.View details
POST/security/v1/portal/generate_tokenGenerates token for portal login.View details
POST/security/v1/portal/validate_tokenValidates token for portal login.View details
POST/security/check_blsChecks customer against restrictive lists (BLS).View details

🔗 Version v3 - Experian & Inspektor Integration

MethodEndpointDescriptionExchange Link
POST/v3/customer/identity/validateIdentity validation with Experian.View details
POST/v3/security/OTP/initializeSends OTP using Experian service.View details
POST/v3/security/OTP/validateValidates OTP via Experian.View details
POST/v3/security/survey/generateGenerates security survey using Experian.View details
POST/v3/security/survey/validateValidates survey via Experian.View details
POST/v3/security/portal/generate_tokenGenerates token (v3 version).View details
POST/v3/security/portal/validate_tokenValidates token (v3 version).View details
POST/v3/security/check_blsRestrictive list check via Inspektor.View details
POST/v3/security/restrictiveList/inspektorQueries Inspektor restrictive lists.View details
POST/v3/security/authentication/businessAuthenticates business users.View details
POST/v3/security/authentication/supplierAuthenticates suppliers.View details

🔐 Version v4 - Token Management

MethodEndpointDescriptionExchange Link
POST/v4/customer/identity/portal/generate_tokenGenerates identity portal token.View details
POST/v4/customer/identity/portal/validate_tokenValidates identity portal token.View details

🌐 Third-party Integrations

MethodEndpointDescriptionExchange Link
GET/data-credito/HC2Queries Experian + Registraduría.View details
GET/fasecolda/obtainUrlRetrieves Fasecolda auth URL.View details
GET/ariba/obtainPendingSuppliersGets pending Ariba suppliers.View details
POST/assessment-filesSends authentication assessment files.View details

📁 Files & TransUnion Services

MethodEndpointDescriptionExchange Link
POST/identity-and-phone-verificationVerifies identity and phone via TransUnion.View details
POST/otp-phone-selectionSelects phone number for TransUnion OTP.View details
POST/otp-pin-verification-otp-inputVerifies entered OTP PIN (TransUnion).View details
POST/obtaining-and-responding-examExecutes and responds to TransUnion security exam.View details
POST/identity-validation-statusSave states of the IVR in Salesforce.View details

📤 Example Request (Generic)

curl -X POST "<endpoint>" \
-H "Content-Type: application/json" \
-d '{ "key": "value" }'

Replace <endpoint> and the payload based on the specific method.

⚠️ Error Handling

Standard HTTP status codes are used for error handling:

  • 200 OK – Request was successful
  • 400 Bad Request – Missing or invalid parameters
  • 401 Unauthorized – Authentication failed
  • 404 Not Found – Endpoint or resource not found
  • 500 Internal Server Error – Unexpected error on the server

📞 Support

For any issues, please contact the API support team:

Integration Services and Applications Coordination

📧 epalma@fgs.co

📅 Notes

Reviews