Validar condiciones para proceder con la venta - Conectados

Este endpoint permite validar las condiciones necesarias para que un usuario pueda proceder con una venta. Evalúa requisitos específicos como la tienda, la categoría de la transacción y el monto solicitado, asegurando que todo esté en orden antes de continuar con la operación.

Si las condiciones se cumplen:
• Se puede generar un código de aprobación que se envía al usuario para confirmar la compra.
• También es posible habilitar la venta directamente, sin necesidad de enviar un código, dependiendo de cómo se solicite la identificación del usuario, como cuando se escanea el código QR de la tarjeta de identificación.
• Además, se tendrán en cuenta los montos de las ventas para evaluar si es necesario enviar un código o no.

Request

Body Params application/json

user_id

string

optional

Identificación del usuario, (DNI, Pasaporte) Example: 1111111-1

categories

array [object {2}]

required

Categorías con sus respectivos montos

integer

required

Identificador de la categoría

amount

integer

required

monto de la categoría

user_rich_data

string

optional

Información sobre el usuario recopilada a través de un escaneo de su cédula de identidad

Example: https://portal.sidiv.registrocivil.cl/docstatus?RUN=12345678-9&type=CEDULA&serial=123456789&mrz=123456789012345678901234

wallet_ids

array[integer]

optional

Listado de billeteras

Example

{
    "user_id": "12345678-9",
    "currency": "CLP",
    "categories": [
        {
            "id": 1,
            "amount": 1000
        },
        {
            "id": 2,
            "amount": 2000
        }
    ]
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢201Created

application/json

Body

integer

required

Identificador único de esta respuesta. | longitud máxima 19

code

integer

required

Codigo interno que referencia el caso de uso de la respuesta

status

string

required

nombre del estado que identifica la respuesta

message

string

required

Mensaje descriptivo de la respuesta

purchase_allowed

boolean

required

Indica si el cliente está autorizado para proceder con la compra

requires_code

boolean

required

Indica si es necesario un código para completar la transacción

code_sent

boolean

required

Indica si el código ha sido enviado al cliente

code_valid_until

string

required

Fecha y hora en formato ISO 8601 que indica hasta cuándo es válido el código enviado. | longitud máxima 24

sale_id

integer

required

Identificador único de la venta asociada al código generado | longitud máxima 19

approval_sale_code

string

required

El código de aprobación de la venta

approval_code_valid_until

string

required

Validez de código de aprobación de venta

aproved_details

array [object {2}]

required

Aggreglo de montos autorizados separados por categoria

category_id

string

required

Id de la categoria con monto autorizado para la compra

amount

integer

required

Monto autorizado para esa categoria

rejected_details

array [object {3}]

required

Arreglo de montos no autorizados por categoria

category_id

string

required

Id de la categoria para la cual hay monto no autorizados

amount

string

required

Monto no autorizado para esa categoria

reject_reason

string

required

Motivo por el cual no se ha autorizado

Example

{
    "id": 12345,
    "code": 0,
    "status": "created",
    "message": "La solicitud fue procesada con éxito",
    "purchase_allowed": true,
    "requires_code": true,
    "sale_id": 12345,
    "approval_sale_code": "1a2b3c4d5e6f7g8h9i0j",
    "code_sent": true,
    "aproved_total_amount": 11000,
    "aproved_details": [
        {
            "category_id": "49835",
            "amount": 1000
        },
        {
            "category_id": "21394",
            "amount": 10000
        }
    ],
    "rejected_details": [
        {
            "category_id": "49835",
            "amount": 1000,
            "rejection_reason": "category not allowed"
        }
    ],
    "code_valid_until": "2025-02-25T12:44:56Z",
    "approval_code_valid_until": "2025-02-25T12:44:56Z"
}

🟠404store not enabled

🟠404Not benefits available

🟠409missing contact info

🟠422unprocessable entity