Validar condiciones para proceder con la venta

POST

/store/$id/sales/approval

Este endpoint valida si un usuario está habilitado para realizar una venta. Verifica categorías, billeteras disponibles y el monto total solicitado. También valida la identidad del usuario mediante QR (con certificadora autorizada) o identificación verbal.

Según el monto y el método de identificación, puede:

Aprobar la venta directamente.

Requerir autenticación OTP adicional.

Si la validación es exitosa:

Se genera un transaction_id para trazabilidad.

Se devuelve un approval_sale_code para continuar con la venta.

Se bloquean las billeteras involucradas por un tiempo limitado para proteger el proceso.

Request Example

Shell

JavaScript

Java

Swift

cURL

Con user_identityCon qr_user_info

curl --location --request POST '/store/$id/sales/approval' \
--header 'Content-Type: application/json' \
--data-raw '{
    "user_identity": "12345678-9",
    "currency": "CLP",
    "categories": [
        {
            "id": 1,
            "amount": 1000
        },
        {
            "id": 2,
            "amount": 2000
        }
    ]
}'

Response Example

201 - Success

{
    "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": "Categoría no permitida"
        }
    ],
    "code_valid_until": "2025-02-25T12:44:56Z",
    "approval_code_valid_until": "2025-02-25T12:44:56Z"
}

Request

Body Params application/json

Examples

Responses

🟢201Created

application/json

Body

🟠404store not enabled

🟠404Not benefits available

🟠409missing contact info

🟠409failed

Modified at 2025-06-30 18:38:06

Crear una transacción

Crear una venta