Wallet

Cuentas

Crear cuenta

POST

/walletentidad-cuenta/v1/api/v1.201/Cuenta

Crea una nueva cuenta para un cliente.

Este endpoint no será utilizado por la organización si la misma usa nuestro Onboarding para dar de altas las cuentas de sus usuarios.

Por apetito de riesgo del negocio no se pueden crear cuentas a CUIT que tengan más de 30 CBU/CVU contemplando cualquier banco o PSP (límite configurable por organización).

Request

codigo string
— OPTIONAL
Identificador externo de la entidad.

cuitCuil string
— REQUIRED
CUIT/CUIL del titular de la cuenta.

nombre string
— REQUIRED
Nombres del titular de la cuenta.

apellido string
— REQUIRED
Apellidos del titular de la cuenta.

razonSocial string
— REQUIRED
Razón Social del titular de la cuenta.

email string
— REQUIRED
Correo electrónico del titular de la cuenta.

celular string
— REQUIRED
Número de teléfono celular del titular de la cuenta.

actividadAfip string
— REQUIRED
Código de actividad económica en ARCA (6 dígitos) del titular de la cuenta.
Valores posibles si tiene actividad: Ver lista de actividades ARCA
Valores posibles si no tiene actividad (Indicar según ocupación): "000007" = Jubilado, "000008" = Estudiante, "000009" = Ama de casa, "000010" = Ex Agente de la Adm. Publica, "000011" = Trabajo Relac. Dependencia, "000012" = Sin Actividad Economica, "000013" = Agricultura Familiar

habilitado boolean
— OPTIONAL
Indica si la cuenta debe ser creada habilitada o deshabilitada. Por defecto, una cuenta se crea deshabilitada.

domicilio object
— REQUIRED
Objeto con información relativa al domicilio del titular de la cuenta.

domicilio.calle string
— REQUIRED
Calle del domicilio del titular de la cuenta.

domicilio.numero string
— REQUIRED
Número del domicilio del titular de la cuenta.

domicilio.piso string
— OPTIONAL
Piso del domicilio del titular de la cuenta.

domicilio.departamento string
— OPTIONAL
Departamento del domicilio del titular de la cuenta.

domicilio.localidadCodigo int
— REQUIRED
Código de localidad del domicilio del titular de la cuenta.
Valores permitidos: Consultar localidades

domicilio.provinciaCodigo int
— REQUIRED
Código de la provincia del domicilio del titular de la cuenta.
Valores permitidos: Consultar provincias

domicilio.cp string
— REQUIRED
Código postal del domicilio del titular de la cuenta.

esPep boolean
— REQUIRED
Indica si el titular de la cuenta es una persona polititamente expuesta.

esFatca boolean
— REQUIRED
Indica si el titular de la cuenta es FATCA

esUif boolean
— REQUIRED
Indica si el titular de la cuenta es un sujeto obligado ante la UIF.

nacionalidad string
— REQUIRED
Nacionalidad del titular de la cuenta. En formato código ISO de dos letras. Ejemplo: Argentina = "AR"

fechaNacimiento datetime
— REQUIRED
Fecha de nacimiento del titular de la cuenta.

ocupacion string
Ocupación del titular de la cuenta.
Valores permitidos: "JUBILADO", "ESTUDIANTE", "TRABAJADOR EN RELACIÓN DE DEPENDENCIA", "AMA DE CASA", "DESOCUPADO", "TRABAJADOR INDEPENDIENTE"

estadoCivil string
Estado civil del titular de la cuenta.
Valores permitidos: "SOLTERO", "CASADO", "VIUDO", "SEPARADO", "DIVORCIADO"

dni string
— REQUIRED
DNI del titular de la cuenta. Opcional si es persona jurídica.

Response

id string
Identificador de la cuenta creada. Se utiliza para realizar acciones sobre la misma, por ejemplo: Crear CVU

habilitado boolean
Indica si la cuenta se creó habilitada o deshabilitada.

curl request

Copy code

curl --location 'https://gw-staging-qrbind.epays.services/walletentidad-cuenta/v1/api/v1.201/Cuenta' \
--header 'Authorization: Bearer {{access_token}}'
--header 'Content-Type: application/json' \
--data-raw '{
    "codigo": "codigo125",
    "cuitCuil": "20374315679",
    "nombre": "Juan",
    "apellido": "Perez",
    "razonSocial": "Juan Perez SA",
    "email": "juanperez@gmail.com",
    "celular": "1168599999",
    "actividadAfip": "000012",
    "habilitado": true,
    "datosDomicilio": {
        "calle": "Maipu",
        "numero": "1012",
        "piso": "7",
        "departamento": null,
        "localidadId": 247,
        "provinciaId": 1,
        "cp": "1006"
    },
    "esPep": false,
    "esFacta": false,
    "esUif": false,
    "nacionalidad": "AR",
    "fechaNacimiento":"1989-02-16",
    "ocupacion":"ESTUDIANTE",
    "estadoCivil":"CASADO",
    "dni":"37431567"
}'

HTTP 201

Creación de cuenta realizada

HTTP 409

El código ya existe

HTTP 400

Algún dato ingresado tiene un formato inválido

HTTP 401

Token de autenticación inválido

`HTTP`	`eventId`	Detalle
`201`	-	Creación exitosa.
`422`	`99000`	Organización inválida (error de configuración)
`400`	`BadRequest`	Fallo de validación de algún campo del request
`400`	`1250`	Razon social es obligatorio para persona jurídica
`422`	`1023`	La orgnización no existe (error de configuración)
`422`	`1026`	El código indicado ya existe en otra cuenta
`422`	`1272`	Supera límite de CBU totales permitidos
`422`	`1273`	Supera límite de CVU totales permitidos
`422`	`1274`	Supera límite total de CVU y CBU totales permitidos
`422`	`1278`	Falta una configuración en la organización
`422`	`1166`	Id de provincia inválido
`422`	`1165`	Id de localidad inválido
`404`	`1087`	Código ISO de país incorrecto
`503`	`1275`	Hubo un error de conexión con el servicio externo
`429`	-	Superó el límite de peticiones de API
`500`	-	Error desconocido

Guías

¿Qué debes saber sobre las cuentas?

API Reference

POST

Crear cuenta

PATCH

Habilitar/deshabilitar cuenta

PUT

Modificar cuenta

GET

Consultar cuenta por ID

GET

Consultar cuentas por CUIT

GET

Consultar cuentas por email

GET

Consultar cuentas por celular

EVENT

Aviso de cuenta deshabilitada