---
title: "Activate a plan for a customer"
method: POST
path: "/v1/sdk/activate"
tags: ["Activation"]
---

# Activate a plan for a customer

`POST /v1/sdk/activate`

Activates a specific plan on a product for a customer. Usage-based (PAYG) plans are topup-first: a zero-balance customer receives `topup_required` and only activates after a successful top-up, while free plans activate immediately and paid recurring / hybrid plans return `payment_required`.

## Request body

- ActivatePlanDto
  - `customerRef` string, required
  - `planRef` string, required
  - `productRef` string, required

## Response `200`

Plan activation result

- ActivatePlanResponseDto
  - `checkoutSessionId` string
  - `checkoutUrl` string
  - `creditBalance` number
  - `creditsPerUnit` number
  - `currency` string
  - `message` string
  - `purchaseRef` string
  - `status` 'activated' | 'already_active' | 'topup_required' | 'payment_required' | 'invalid', required

## Changes

- **2026-07-17** `bbc2ff2bc849` — 3 warning
  - the `customerRef` request property's maxLength was set to `20`
  - the `planRef` request property's maxLength was set to `20`
  - the `productRef` request property's maxLength was set to `20`
- **2026-07-04** `a30b6aef464d` — 2 info
  - the endpoint scheme security `SecretKey` was added to the API
  - the endpoint scheme security `bearer` was removed from the API
- **2026-04-09** `7b327a22e3cb` — 1 warning, 1 info
  - removed the optional property `pricePerUnit` from the response with the `200` status
  - added the optional property `creditsPerUnit` to the response with the `200` status
- **2026-04-08** `052cc028fdfa` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/solvapay/apis/solvapay-rest-api/changes/v1/sdk/activate/post.md)

---

[API](https://skmtc.dev/solvapay/apis/solvapay-rest-api.md) · [All operations](https://skmtc.dev/solvapay/apis/solvapay-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/solvapay/solvapay-rest-api/revisions/bbc2ff2bc849/schema)