Crea una solicitud de onboarding

Productos en los que aplica:

ONBOARDING

Descripción

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

Endpoint

POST

/ot-clone/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.

Ejemplo de request

Copy code

curl --location 'https://gw-staging-qrbind.epays.services/ot-clone/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:
- 1: Pendiente
- 2: Aprobada
- 3: Rechazada
- 4: Error en alta
- 5: Validación manual.

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.

Ejemplo de response

HTTP 201

Onboarding aprobado. Cuentas creadas satisfactoriamente.

Copy code

HTTP 201

Onboarding aprobado. Cuentas creadas satisfactoriamente.

Copy code

HTTP 201

Onboarding aprobado. Cuentas creadas satisfactoriamente.

Copy code

HTTP 401

Token de autenticación inválido

Copy code

HTTP 401

Token de autenticación inválido

Copy code

HTTP 401

Token de autenticación inválido

Copy code

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.

Copy code

HTTP 422

Copy code

HTTP 422

Copy code

HTTP 422

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

Copy code

HTTP 422

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

Copy code

HTTP 422

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

Copy code

HTTP 422

Onboarding rechazado porqueRenaper no reconoce el documento

Copy code

HTTP 422

Onboarding rechazado porqueRenaper no reconoce el documento

Copy code

HTTP 422

Onboarding rechazado porqueRenaper no reconoce el documento

Copy code

HTTP 422

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

Copy code

HTTP 422

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

Copy code

HTTP 422

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

Copy code

HTTP 422

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

Copy code

HTTP 422

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

Copy code

HTTP 422

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

Copy code

Descripción

Endpoint

Request

Ejemplo de request

Response

Ejemplo de response

DEVELOPERS

Filtrar por producto:

QR ESTÁTICO

QR DINÁMICO

REC. X TRANSFERENCIA

BOTÓN SIMPLE

DISPOSITIVO POS

WALLET / PSP

Autenticación

Cobrar con QR estático

Cobrar con QR dinámico

Cobrar con botón de pagos

Cobrar con transferencia

Comercio

Comprobantes

Operaciones

Webhooks

Archivos batch

Productos