El endpoint de registro de tercero y usuario permite crear un nuevo tercero en el sistema. Este proceso es esencial para asegurar que todos los datos relevantes de los terceros y usuarios se capturen y gestionen correctamente.
Parámetros para el Endpoint
A continuación se detallan los parámetros necesarios para registrar un nuevo tercero y usuario:
Objeto para el envío de datos.
{
"tradeName": "OFFICWEE COL",
"legalName": "OFFIC",
"document": "324232323",
"typeDocumentId": "3",
"dv": "7",
"emailNotification": "[email protected]",
"indicativeContact": "+57",
"phoneContact": "3000090987",
"categoryId": "3",
"address": "7217 NW 2nd Ave",
"thirdDirectory": {
"name": "juan C",
"lastName": "Armeria",
"document": "55625685",
"typeDocumentId": 1,
"emailNotification": "[email protected]",
"indicativeContact": "+57",
"phoneContact": "30000909875",
"categoryId": 3,
"address": "7217 NW 2nd Ave",
"thirdCredentials": {
"type": "CARD",
"fullName": "Pepito Perez",
"accountNumber": "99999999",
"expirationDate": "203112"
}
}
}
Explicación de tabla.
PN: Persona Natural
PJ: Persona Jurídica
| PARÁMETRO | DESCRIPCIÓN | PN | PJ |
|---|---|---|---|
| name | Nombre de pila de la persona. | X | |
| lastName | Apellido de la persona. | X | |
| tradeName | solo cuando el tipo de documento es 3(NIT) Nombre bajo el que se desarrolla la actividad comercial. En este caso, podría ser el nombre de un negocio o emprendimiento. | X | |
| legalName | solo cuando el tipo de documento es 3(NIT) Nombre oficial registrado ante las autoridades. En este caso, podría ser la razón social de una empresa. | X | |
| document | Número de documento del tercero principal. | X | X |
| typeDocumentId | ID del tipo de documento del tercero principal. | X | X |
| dv | Dígito de verificación del documento (solo si el tipo de documento lo requiere). | X | |
| emailNotification | Dirección de correo electrónico para notificaciones del tercero principal. | X | X |
| indicativeContact | Indicativo de país para el número de teléfono de contacto del tercero principal. | X | X |
| phoneContact | Número de teléfono de contacto del tercero principal. | X | X |
| categoryId | ID de la categoría del tercero principal. | X | X |
| address | Dirección física del usuario tercero principal. | X | X |
| thirdDirectory.name | Nombre de pila de la persona. | X | |
| thirdDirectory.lastName | Apellido de la persona. | X | |
| thirdDirectory.tradeName | solo cuando el tipo de documento es 3(NIT) Nombre bajo el que se desarrolla la actividad comercial. En este caso, podría ser el nombre de un negocio o emprendimiento. | X | |
| thirdDirectory.legalName | solo cuando el tipo de documento es 3(NIT) Nombre oficial registrado ante las autoridades. En este caso, podría ser la razón social de una empresa. | X | |
| thirdDirectory.document | Documento del usuario tercero. | X | X |
| thirdDirectory.typeDocumentId | ID del tipo de documento del usuario tercero. | X | X |
| thirdDirectory.dv | Dígito de verificación del documento del usuario tercero (solo si el tipo de documento lo requiere). | X | |
| thirdDirectory.emailNotification | Dirección de correo electrónico para notificaciones del usuario tercero. | X | X |
| thirdDirectory.indicativeContact | Indicativo de país para el número de teléfono de contacto del usuario tercero. | X | X |
| thirdDirectory.phoneContact | Número de teléfono de contacto del usuario tercero. | X | X |
| thirdDirectory.categoryId | ID de la categoría del usuario tercero. | X | X |
| thirdDirectory.address | Dirección física del usuario tercero. | X | X |
| thirdDirectory.thirdCredentials.type | Tipo de credencial utilizada para las transacciones (ej., tarjeta, cuenta bancaria). | X | X |
| thirdDirectory.thirdCredentials.fullName | Nombre completo del titular de la credencial del usuario tercero. | X | X |
| thirdDirectory.thirdCredentials.accountNumber | Número de cuenta o tarjeta del usuario tercero. | X | X |
| thirdDirectory.thirdCredentials.expirationDate | Fecha de expiración de la tarjeta del usuario tercero en formato YYYYMM. | X | X |
Campos de respuesta
| Campo | Descripción |
|---|---|
error | Indica si hubo un error. 0 significa que no hubo error. |
message | Mensaje descriptivo del resultado de la operación. |
data | Contiene la información relacionada con el registro guardado. |
data.uuid | UUID del tercero, identificador único. |
data.thirdBankUuid | UUID del método de pago del tercero. |
Notas Adicionales:
Cumplimiento PCI DSS: Para capturar y procesar los datos de la tarjeta de crédito, es necesario cumplir con los estándares de seguridad PCI DSS (Payment Card Industry Data Security Standard). Asegúrese de que su integración cumpla con estas normas para garantizar la seguridad de los datos de la tarjeta.
SDK y Webapp (White Label): Si no cumple con los requisitos PCI DSS es decir no cuenta con una AOC válida, ofrecemos un SDK y un sitio web marca blanca que simplifican la integración y aseguran el cumplimiento con las normas de seguridad. Contáctenos para obtener más información y asistencia con estas herramientas.
¿Qué es un AOC (Attestation of Compliance)?
Una atestación de cumplimiento o AOC (Attestation of Compliance) es un documento que da fe de los resultados de la evaluación de PCI DSS e incluye la firma de un auditor profesional certificado por PCI DSS