---
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

---

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