Respuestas de validaciĂłn de cupones
En esta sección encontrarås las posibles respuestas al validar cupones, con detalles sobre cada una, e incluyendo casos de éxito, pendencia, invalidez y error.
Status | DescripciĂłn |
success | Cupón validado con éxito. Estå asociado a un descuento. |
pending | CupĂłn listo para ser utilizado para realizar un pago. |
invalid | CupĂłn incorrecto. No estĂĄ asociado a un descuento. |
Ăxito
- CupĂłn vĂĄlido con descuento asociado
- CĂłdigo de estado: 200 (Success)
- DescripciĂłn: respuesta que indica Ă©xito en la validaciĂłn del cupĂłn, vinculado a un descuento activo. Incluye los tĂ©rminos legales, el valor del descuento, tipo, lĂmite mĂĄximo y los montos mĂnimos y mĂĄximos aplicables al pago.
- Cuerpo de la respuesta:
Json
{ "status": "success", "description": "Descripción del cupón mostrada a los clientes, por ejemplo, en interfaces, facturas o recibos", "legal_terms": "URL de los términos y condiciones para fines legales", "details": { "value": 10.0, "type": "percentl", "cap": 1000.0, "min_payment_amount": 100.0, "max_payment_amount": 10000.0 } }
- CupĂłn con descuento listo para uso
- CĂłdigo de estado: 200 (Success)
- Descripción: respuesta que confirma que el cupón estå listo para su uso, a la espera de ser aplicado en un pago. Incluye detalles del descuento y términos legales.
- Cuerpo de la respuesta:
Json
{ "status": "pending", "description": "Descripción del cupón, como se muestra a los clientes en interfaces, facturas o recibos.", "legal_terms": "URL de los términos y condiciones para fines legales.", "details": { "value": 10.0, "type": "percent", "cap": 1000.0, "min_payment_amount": 100.0, "max_payment_amount": 10000.0 } }
- CupĂłn sin descuento asociado
- CĂłdigo de estado: 200
- DescripciĂłn: respuesta que indica que el cupĂłn enviado es invĂĄlido y no tiene un descuento asociado.
- Cuerpo de la respuesta:
Json
{ "status": "invalid" }
Error
- Solicitud mal formulada
- CĂłdigo de estado: 400 (Bad Request).
- DescripciĂłn: respuesta de error que indica que la solicitud fue mal formulada. Incluye un mensaje de error detallado con el cĂłdigo de estado correspondiente.
- Cuerpo de la respuesta:
Json
{ "error": "bad_request", "message": "mensaje de error detallado", "status": 400 }
- Coupon_id invĂĄlido
- CĂłdigo de estado: 400 (Bad Request).
- DescripciĂłn: respuesta de error que indica que el
coupon_id
enviado en la solicitud es invĂĄlido. - Cuerpo de la respuesta:
json
{ "error": "bad_request", "message": "Invalid coupon_id.", "status": 400 }
- Payer_token invĂĄlido
- CĂłdigo de estado: 400 (Bad Request).
- DescripciĂłn: respuesta de error que indica que el
payer_token
enviado en la solicitud es invĂĄlido. - Cuerpo de la respuesta:
json
{ "error": "bad_request", "message": "Invalid payer token.", "status": 400 }