Rechazo de aprobación

Developing

POST

/api/webhooks/retail-events

Este evento indica que la validación de condiciones necesarias para realizar una venta ha fallado. Puede deberse a que el usuario no cumple con los requisitos establecidos, como montos insuficientes, categorías no habilitadas, billeteras no disponibles o fallos en la verificación de identidad.

A pesar del rechazo, se genera un transaction_id interno para fines de trazabilidad y auditoría. No se emite un approval_sale_code y la venta no puede continuar.

Request

Body Params application/json

Example

{
  "event_type": "sale_conditions_rejected",
  "code": 100,
  "status": "rejected",
  "message": "El cliente no cumple con las condiciones para realizar la venta",
  "purchase_allowed": false,
  "aproved_details": [],
  "external_reference": "retail-20250701-abc123",
  "rejected_details": [
    {
      "category_id": "49835",
      "amount": 1000,
      "reject_reason": "beneficio no disponible"
    },
    {
      "category_id": "21394",
      "amount": 10000,
      "reject_reason": "límite mensual alcanzado"
    }
  ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/webhooks/retail-events' \
--header 'Content-Type: application/json' \
--data-raw '{
  "event_type": "sale_conditions_rejected",
  "code": 100,
  "status": "rejected",
  "message": "El cliente no cumple con las condiciones para realizar la venta",
  "purchase_allowed": false,
  "aproved_details": [],
  "external_reference": "retail-20250701-abc123",
  "rejected_details": [
    {
      "category_id": "49835",
      "amount": 1000,
      "reject_reason": "beneficio no disponible"
    },
    {
      "category_id": "21394",
      "amount": 10000,
      "reject_reason": "límite mensual alcanzado"
    }
  ]
}'

Responses

🟢201Created

application/json

Body

Example

{
  "status": "received",
  "message": "Webhook processed successfully",
  "event": "sale_conditions_rejected",
  "transaction_id": 12345
}

Modified at 2025-07-01 19:05:52

Aprobar condiciones

Crear Venta