Validate the voucher
POST
https://evo-integracao-api.w12app.com.br/api/v1/voucher/voucher-verify
🌐 API Reference/Voucher
Validar cupón
Descripción
📨 Cuerpo de la Requisición (Request Body)
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
voucher | string | Sí | Código del voucher a validar. |
idMembership | int32 | Sí | ID del contrato asociado. |
idService | int32 | No | ID del servicio asociado. |
idBranch | int32 | Sí | ID de la unidad. |
📤 Estructura de la Respuesta
| Campo | Tipo | Descripción |
|---|---|---|
idVoucher | int32 | Identificador del voucher en el sistema. |
idVoucherItem | int32 | Identificador del ítem del voucher. |
voucher | string | Código del voucher informado en la validación. |
flFreePass | boolean | Indica si el voucher concede acceso gratuito. |
membershipValue | number | Valor original del contrato antes de aplicar el descuento. |
discountKind | int32 | Tipo de descuento aplicado al contrato. |
discountValue | number | Valor del descuento aplicado al contrato. |
finalMembershipValue | number | Valor final del contrato tras aplicar el descuento. |
flSingleServiceDiscount | boolean | Indica si el voucher tiene descuento para servicio único. |
singleServiceValue | number | Valor original del servicio único. |
singleServiceDiscountKind | int32 | Tipo de descuento aplicado al servicio único. |
singleServiceDiscountValue | number | Valor del descuento aplicado al servicio único. |
finalSingleServiceDiscountValue | number | Valor final del servicio único tras aplicar el descuento. |
flRecurringDiscount | boolean | Indica si el voucher tiene descuento recurrente. |
monthsRecurringDiscount | int32 | Número de meses en que se aplicará el descuento recurrente. |
flAnnuityDiscount | boolean | Indica si el voucher tiene descuento en la anualidad. |
annuityValue | number | Valor original de la anualidad. |
annuityDiscountKind | int32 | Tipo de descuento aplicado a la anualidad. |
annuityDiscountValue | number | Valor del descuento aplicado a la anualidad. |
finalAnnuityValue | number | Valor final de la anualidad tras aplicar el descuento. |
dayAnnuity | int32 | Día configurado para el cobro de la anualidad. |
monthAnnuity | int32 | Mes configurado para el cobro de la anualidad. |
finalValue | number | Valor total final tras aplicar todos los descuentos del voucher. |
Solicitud
Parámetros del Body
application/json-patch+json
Respuestas
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location 'https://evo-integracao-api.w12app.com.br/api/v1/voucher/voucher-verify' \
--header 'Content-Type: application/json-patch+json' \
--data '{
"idBranch": 0,
"voucher": "string",
"idMembership": 0,
"idService": 0
}'Respuesta Ejemplo de Respuesta
200 - Ejemplo 1
{
"idVoucher": 0,
"idVoucherItem": 0,
"voucher": "string",
"flFreePass": true,
"membershipValue": 0,
"discountKind": 0,
"discountValue": 0,
"finalMembershipValue": 0,
"flSingleServiceDiscount": true,
"singleServiceValue": 0,
"singleServiceDiscountKind": 0,
"singleServiceDiscountValue": 0,
"finalSingleServiceDiscountValue": 0,
"flRecurringDiscount": true,
"monthsRecurringDiscount": 0,
"flAnnuityDiscount": true,
"annuityValue": 0,
"annuityDiscountKind": 0,
"annuityDiscountValue": 0,
"finalAnnuityValue": 0,
"dayAnnuity": 0,
"monthAnnuity": 0,
"finalValue": 0
}Modificado en 2026-05-15 13:34:34