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

Body Params application/json

Examples

Con user_identityCon qr_user_info

{
    "user_identity": "12345678-9",
    "currency": "CLP",
    "cashier": "CASH-002",
    "sale_type": "Boleta",
    "external_reference": "retail-20250701-abc123",
    "wallet_ids": [
        2
    ],
    "categories": [
        {
            "id": 1,
            "amount": 1000
        },
        {
            "id": 2,
            "amount": 2000
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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",
    "cashier": "CASH-002",
    "sale_type": "Boleta",
    "external_reference": "retail-20250701-abc123",
    "wallet_ids": [
        2
    ],
    "categories": [
        {
            "id": 1,
            "amount": 1000
        },
        {
            "id": 2,
            "amount": 2000
        }
    ]
}'

Responses

🟢200OK

application/json

Body

Example

{
  "code": 0,
  "status": "accepted",
  "message": "La solicitud fue aceptada, se notificará por webhook"
}

Modified at 2025-07-01 19:12:50

Obtener el Saldo de un Billetera Habiente

Anular la venta