Developers

General

Wallet

Cobro

Onboarding

Registro único

Validación por partes

Consultas solicitudes

Webhooks

Agente de cobros

ONBOARDING

>

Registro único

Registro único CVU

Crea una solicitud de onboarding para validación de un usuario y posterior creación de cuenta.

Endpoint

POST

/orquestador/api/v1/onboarding

Request

externalrefid string
— OPTIONAL
Identificador externo indicado por la propia Entidad.

frente string
— REQUIRED
Foto del frente del DNI en Base64.
Tamaño máximo permitido: 1 MB.

dorso string
— REQUIRED
Foto del dorso del DNI en Base64.
Tamaño máximo permitido: 1 MB.

documento string
— OPTIONAL
Número de DNI.
Puede enviarse este dato adicionalmente a las fotos del DNI para poder avanzar si es que no podemos obtenerlo de las imágenes enviadas (codigo de error: “PDF417_NO_ENCONTRADO”)

documentoTramite string
— OPTIONAL
Número de trámite del documento. Puede enviarse este dato adicionalmente a las fotos del DNI para poder avanzar si es que no podemos obtenerlo de las imágenes enviadas (codigo de error: “PDF417_NO_ENCONTRADO”)

genero string
— OPTIONAL
Género.
Puede enviarse este dato adicionalmente a las fotos del DNI para poder avanzar si es que no podemos obtenerlo de las imágenes enviadas (codigo de error: “PDF417_NO_ENCONTRADO”)
Valores permitidos:
- “M”
- “F”
- “X”

selfie string
— REQUIRED
Foto selfie del usuario en Base64.
Tamaño máximo permitido: 1 MB.

email string
— REQUIRED
Correo electrónico del usuario.

telefono string
— REQUIRED
Número telefónico del usuario.

maritalState string
— REQUIRED
Estado civil.
Valores permitidos:
- “SOLTERO”
- “CASADO”
- “VIUDO”
- “SEPARADO”
- “DIVORCIADO”

occupation string
— REQUIRED
Ocupación.
Valores permitidos:
- “JUBILADO”
- “ESTUDIANTE”
- “TRABAJADOR EN RELACIÓN DE DEPENDENCIA”
- “AMA DE CASA”
- “DESOCUPADO”

isOcde boolean
— REQUIRED
Indica si el usuario declaró que es OCDE o no.

ocdeTimeStamp string
— REQUIRED
Fecha y hora en que el usuario registró la declaración jurada.

ocdeCountryTaxResidencePrincipal string
— OPTIONAL
País principal donde tributa - ISO 2 letras. Es obligatorio si el usuario declaró que es OCDE.

ocdeNitPrincipal string
— OPTIONAL
Número NIT principal. Es obligatorio si el usuario declaró que es OCDE.

ocdeNitOpcional string
— REQUIRED
Número NIT opcional. Es obligatorio si el usuario declaró que es OCDE.

isFatca boolean
— REQUIRED
Indica si el usuario declaró que es FATCA o no.

fatcaTimeStamp boolean
— REQUIRED
Fecha y hora en que el usuario registró la declaración jurada.

factaSsn string
— OPTIONAL
Número de SSN de FATCA. Es obligatorio si el usuario declaró que es FATCA.

isPEP boolean
— REQUIRED
Indica si el usuario declaró que es PEP o no.

pepTimeStamp string
— REQUIRED
Fecha y hora en que el usuario registró la declaración jurada.

pepDescription boolean
— OPTIONAL
Descripción del motivo (posición, puesto político). Es obligatorio si el usuario declaró que es PEP.

isUIF boolean
— REQUIRED
Indica si el usuario declaró que es UIF o no.

uifTimeStamp string
— REQUIRED
Fecha y hora en que el usuario registró la declaración jurada.

isTyc boolean
— REQUIRED
Indica si el usuario aceptó los TyC.

tycTimeStamp string
— REQUIRED
Fecha y hora en que el usuario aceptó los TyC.

curl request

Copy code

curl --location 'https://gw-staging-qrbind.epays.services/orquestador/api/v1/onboarding' \
--header 'Cache-Control: no-cache' \
--header 'Content-Type: application/json' \
--header 'Authorization: {{access_token}}' \
--data-raw '{
  "externalrefid": "789654",
  "frente": "fotoEnBase64DelFrenteDelDni",
  "dorso": "fotoEnBase64DelDorsoDelDni",
  "documento": null,
  "documentoTramite": null,
  "genero": null,
  "selfie": "fotoEnBase64SelfieDelUsuario",
  "email": "pagomes@bind.com.ar",
  "telefono": "1169991243",
  "maritalState": "SOLTERO",
  "occupation": "TRABAJADOR EN RELACIÓN DE DEPENDENCIA",
  "isOcde": false,
  "ocdeTimeStamp": "2024-10-23 10:10:48",
  "ocdeCountryTaxResidencePrincipal": null,
  "ocdeNitPrincipal": null,
  "ocdeCountryTaxResidenceOptional": null,
  "ocdeNitOpcional": null,
  "isFatca": false,
  "fatcaTimeStamp": "2024-10-23 10:10:48",
  "factaSsn": null,
  "isPep": false,
  "pepTimeStamp": "2024-10-23 10:10:48",
  "pepDescription": null,
  "isUIF": false,
  "uifTimeStamp": "2024-10-23 10:10:48",
  "isTyc": true,
  "tycTimeStamp": "2024-10-23 10:10:48"
}'

Response

id string
Identificador de la solicitud de onboarding creada.

externalrefid string
Identificador externo indicado por la propia Entidad.

estado int
Estado del onboarding.
Valores permitidos:
- Pendiente = 1
- Aprobada = 2
- Rechazada = 3
- Validación Manual = 4
- Pendiente credenciales = 5
- Error alta = 6
- Aprobado a Revisar = 7
- Aprobado sin notificar = 8
- Vencida = 9
- Menor pendiente = 10
- Menor habilitado = 11

cuenta object
Objeto con información de la cuenta principal a usar en Wallet

cuentaCvu object
Objeto con información del CVU creado asociado a la cuenta.

cuentaInvestment object
Objeto con información de la cuenta comitente creada asociada a la cuenta.

HTTP 201

Onboarding aprobado. Cuentas creadas satisfactoriamente.

HTTP 201

Onboarding aprobado. Cuentas creadas satisfactoriamente.

HTTP 401

Token de autenticación inválido

HTTP 401

Token de autenticación inválido

HTTP 422

Onboarding rechazado porque no se extraer información del código PDF417 del DNI. Puede reintentarse enviando adicionalmente los datos del DNI ingresados manualmente por el usuario para poder continuar.

HTTP 422

Onboarding rechazado porque ya existe una solicitud aprobada de la persona.

HTTP 422

Onboarding rechazado porque ya existe una solicitud aprobada de la persona.

HTTP 422

Onboarding rechazado porqueRenaper no reconoce el documento

HTTP 422

Onboarding rechazado porqueRenaper no reconoce el documento

HTTP 422

Onboarding rechazado porque el DNI ingresado corresponde con una persona fallecida en Renaper

HTTP 422

Onboarding rechazado porque el DNI ingresado corresponde con una persona fallecida en Renaper

HTTP 422

Onboarding rechazado porque el ejemplar del DNI ingresado no está vigente para Renaper

HTTP 422

Onboarding rechazado porque el ejemplar del DNI ingresado no está vigente para Renaper

HTTP 422

Onboarding rechazado porque el usuario tiene una edad menor a la permitida

HTTP 422

Onboarding rechazado porque el usuario tiene una edad menor a la permitida

HTTP 401

Token de autenticación inválido

HTTP 401

Token de autenticación inválido