coupons

Crear un cupón

Crea un nuevo cupón de descuento. Puedes especificar un descuento fijo (amount_off_in_cents) o un porcentaje (percent_off), pero no ambos.

post/coupons

Request

Base URL
https://app.recurrente.com/api
Auth
API key in header X-SECRET-KEY
TypeScript
https://skmtc.dev/recurrente/apis/referencia-api/docs/coupons/post.ts
A function with typed inputs. Its response is checked against the schema.

Cupón creado exitosamente

idstring

ID único del cupón

namestring

Nombre o código del cupón

discount_mode'code' | 'bank' | 'custom_bins'

Tipo de descuento

display_namestring nullable

Nombre visible para el cliente (usado en modo custom_bins)

amount_off_in_centsinteger nullable

Descuento fijo en centavos

percent_offnumber double nullable

Porcentaje de descuento

automatically_appliesboolean

Si el descuento se aplica automáticamente en checkouts de tienda

max_redemptionsinteger nullable

Número máximo de usos

times_redeemedinteger

Número de veces que se ha redimido el descuento

currencystring nullable

Moneda del descuento fijo

duration'once' | 'forever'

Duración del descuento para suscripciones

expires_atstring date-time nullable

Fecha de expiración

statusstring

Estado del cupón

Sep 19, 202633bad9197d59 Revision changes
- breaking
  added to the response property oneOf list for the response status
- breaking
  the / response's property type changed from object to array for status
Sep 17, 20263d76463f9fd8 Revision changes
- warning
  deleted the header request parameter X-SECRET-KEY
- info
  the endpoint scheme security secretKey was added to the API