Queue - Validación KYC

📥 Collection Postman

Descargar Collection - Queue Integration

URLs

Método	URL	Acción	Descripción
POST	/api/v1/integration/queue	Registrar	Crea un objeto en la cola de procesamiento para validación KYC
GET	/api/v1/integration/queue/{id}	Visualizar	Verifica el estado de procesamiento de un objeto en la cola

Producción:

{connect-producao}/api/v1/integration/queue

Homologación:

{connect-homologacao}/api/v1/integration/queue

1 - Obtener token (client_credentials)

auth_url: https://security.fanbase.com.br
grant_type: client_credentials

Solicitud

POST https://security.fanbase.com.br/api/token?grant_type=client_credentials&client_id={client_id}&client_secret={client_secret}

Respuesta (ejemplo)

{
  "access_token": "su_access_token",
  "token_type": "Bearer",
  "expires_in": 3600
}

Autenticación vía QueueApiKey (alternativa)

Como todo el proceso de cola se basa en una interfaz (ifcode), también se permite autenticar sin AccessToken, usando QueueApiKey:

A) Access Token

AccessToken: {access_token}

B) Api Key Header

X-Api-Key: {QueueApiKey}

C) Basic Auth

Authorization: Basic base64({ifcode}:{QueueApiKey})

D) HMAC - SHA256

X-Webhook-Id: {ifcode}
X-Webhook-Signature: sha256={firma_hex}

Fórmula:

HMAC-SHA256(secret, request_body) -> hex string -> prefijo "sha256="

2 - Crear objeto en la cola de procesamiento

api_url: https://connect.fanbase.com.br

Body (ExemploQueueNewC / kyc-validation)

{
  "action": "kyc-validation",
  "data": {
    "firstName": "Joao",
    "lastName": "Exemplo",
    "birthday": "1980-08-05",
    "UserId": 1329964,
    "SSOId": 123456789,
    "Identifier": "joao@exemplo.com",
    "verified": true
  }
}

2.1 - Ejemplo usando AccessToken

POST https://connect.fanbase.com.br/api/v1/integration/queue
AccessToken: {access_token}
Content-Type: application/json

2.2 - Ejemplo usando X-Api-Key

POST https://connect.fanbase.com.br/api/v1/integration/queue
X-Api-Key: {QueueApiKey}
Content-Type: application/json

2.3 - Ejemplo usando Basic Auth

POST https://connect.fanbase.com.br/api/v1/integration/queue
Authorization: Basic base64({ifcode}:{QueueApiKey})
Content-Type: application/json

2.4 - Ejemplo usando HMAC-SHA256

POST https://connect.fanbase.com.br/api/v1/integration/queue
X-Webhook-Id: {ifcode}
X-Webhook-Signature: sha256={firma_hex}
Content-Type: application/json

Respuesta de éxito en creación

Estado: 201 Created

{
  "id": "uuid-del-objeto",
  "created": "2025-01-01T00:00:00Z",
  "iCode": 0,
  "iMsg": "Objeto creado con éxito",
  "processDate": null,
  "processStatus": "pending",
  "processMsg": null
}

3 - Verificar procesamiento del objeto

Use el id devuelto en la creación:

GET https://connect.fanbase.com.br/api/v1/integration/queue/{id}
AccessToken: {access_token}

También puede consultar usando las alternativas de autenticación vía QueueApiKey de la sección anterior.

Respuesta de éxito

Estado: 200 OK

{
  "id": "uuid-del-objeto",
  "created": "2025-01-01T00:00:00Z",
  "iCode": 0,
  "iMsg": "Procesado con éxito",
  "processDate": "2025-01-01T00:05:00Z",
  "processStatus": "completed",
  "processMsg": "Validación KYC concluida",
  "msg": {
    "action": "kyc-validation",
    "data": {
      "firstName": "Joao",
      "lastName": "Exemplo",
      "birthday": "1980-08-05",
      "UserId": 1329964,
      "SSOId": 123456789,
      "Identifier": "joao@exemplo.com",
      "verified": true
    }
  }
}