canonical: https://jentic.com/apis/cuponerapp.com/cuponerapp # Cuponerapp API The Cuponerapp API handles checkout, payments, and coupon redemption for the Cuponerapp platform. Across 5 endpoints it calculates checkout prices, processes payments, redeems coupons, returns coupon details, and reports a user's subscription status. ## For AI agents Calculate a checkout price, process a payment, redeem coupons, and read subscription status for the Cuponerapp platform across 5 endpoints. Authenticates with a bearer token (JWT). ## Scope Does not create coupons, manage a product catalog, or handle refunds. Use for Cuponerapp checkout pricing, payment, coupon redemption, and subscription status only. ## Capabilities - Calculate the checkout price for an order including any coupon discount - Process a payment for a checkout - Redeem a coupon by its ID - Retrieve the details of a coupon - Read a user's subscription status ## Use cases ### Agent-Driven Checkout and Payment An AI agent connected through Jentic can carry a purchase from price to paid. It calculates the checkout price with any coupon applied, confirms the total with the user, and then processes the payment, all through one API. This lets a conversational assistant complete a Cuponerapp purchase without a human moving between screens. Example prompt: Calculate the checkout price for a cart with a coupon applied, confirm the total, then process the payment ### Coupon Validation and Redemption Before honouring a discount, a workflow needs to know a coupon is valid and then mark it used. The Cuponerapp API returns a coupon's details for validation and redeems it by ID, so an agent can check a code, apply it to a price, and redeem it once the purchase completes. Example prompt: Fetch a coupon's details to confirm it is valid, then redeem it by ID after the order is paid ### Subscription Status Checks Features that depend on an active subscription need a quick way to confirm it. The Cuponerapp API reports a user's subscription status, letting an agent gate premium actions or prompt a user to renew before continuing. Example prompt: Read a user's subscription status and only continue with a premium action if the subscription is active ## Key endpoints | Method | Path | Description | | --- | --- | --- | | POST | `/api/checkout/price` | Calculate the checkout price including coupon discounts | | POST | `/api/process-payment` | Process a payment for a checkout | | POST | `/api/cupones/{id}/usar` | Redeem a coupon by its ID | | GET | `/api/coupon-detail` | Retrieve the details of a coupon | | GET | `/api/subscription/status` | Read a user's subscription status | ## Key resources - **Checkout** — Calculate the price of a checkout including coupon discounts - **Payment** — Process a payment for a checkout - **Coupons** — Retrieve coupon details and redeem a coupon by ID - **Subscriptions** — Read a user's subscription status ## Why Jentic - **Setup:** Wiring Cuponerapp by hand means obtaining and refreshing a JWT bearer token and sequencing the checkout, payment, and coupon calls yourself. Through Jentic you install once, import Cuponerapp from the API Directory, store the token once, and your agent calls the operations directly. - **Permission scoping:** You choose which of the five operations your agent may call, and the coupon redemption operation addresses a coupon by ID in the URL path, so a rule can bound it to specific coupons. You might allow checkout pricing and coupon lookup while blocking payment processing. - **Credential handling:** Your Cuponerapp bearer token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'redeem a coupon for a user', and Jentic returns the matching Cuponerapp operation with its input schema so the agent calls it with the right coupon ID. ## Related APIs - **Talon.One** — Promotion and coupon engine for building and managing complex discount campaigns - **Coupon Tools** — Create, distribute, and validate digital coupons and loyalty cards - **Stripe** — General-purpose card and wallet payment processing - **Recurly** — Recurring billing and subscription lifecycle management ## FAQ ### What authentication does the Cuponerapp API use? The Cuponerapp API authenticates every request with a bearer token in JWT format, sent in the Authorization header per its OpenAPI spec. Through Jentic the token is stored once by your own self-hosted instance and injected when the agent calls, so it never appears in the agent's prompt or logs. ### Is there a Cuponerapp MCP server? You don't need an MCP server to give your agent the Cuponerapp API. Jentic connects it directly from the API Directory: import it, store your bearer token once, and your agent calls the checkout, payment, and coupon operations. Operations are discovered on demand, so nothing extra loads into the agent's context. ### Can I limit what my agent is allowed to do with the Cuponerapp API? Yes. You choose which of the five operations the agent may call, and the coupon redemption operation addresses a coupon by its ID in the URL path, so a rule can bound it to specific coupons. You might allow price calculation and coupon lookup while blocking payment processing, with every call logged. ### Can the Cuponerapp API process a payment and apply a coupon in the same flow? Yes. The checkout price operation returns the total with any coupon discount applied, the payment operation processes the charge, and the redemption operation marks the coupon used, so an agent can run price, pay, and redeem as one sequence. ### What are the rate limits for the Cuponerapp API? The OpenAPI spec does not specify rate limits. Check the Cuponerapp documentation at https://cuponerapp.com for current limits before running high-volume checkout or redemption jobs. ### How do I redeem a coupon through Jentic? Search Jentic by intent, for example 'redeem a coupon for a user', and Jentic returns the redemption operation with its input schema. Your agent supplies the coupon ID and reads back the result. To run it on your own infrastructure, install Jentic One from its GitHub repo.