---
title: "Execute Promotion"
method: POST
path: "/v1/billing/promotions/{promotion_id}"
tags: ["Billing", "billing"]
---

# Execute Promotion

`POST /v1/billing/promotions/{promotion_id}`

## Path parameters

- `promotion_id` string, uuid, required

## Request body

- BillingRequestUrls
  - `SuccessUrl` string, required
  - `CancelUrl` string, required
  - `ReturnUrl` string, nullable

## Response `200`

Successful Response

- BillingResponse
  - `CheckoutUrl` string, nullable
  - `ClientSecret` string, nullable
  - `RequestId` string, uuid, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/orsay/apis/fastapi.md) · [All operations](https://skmtc.net/orsay/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/orsay/fastapi/versions/23d1ff06d0d0/schema)