Skip to main content
POST
JavaScript
Este endpoint importa uma chave que você já possui — key, customer_id e product_id são todos obrigatórios. Ele não gera um valor de chave para você. Importar um key que já existe retorna 409 Conflict.
As chaves de licença criadas ou atualizadas por meio da API não acionam notificações por e-mail para os clientes. Se precisar notificar os clientes sobre a chave de licença deles, você deverá fazer isso separadamente na sua aplicação.

Autorizações

Authorization
string
header
obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Corpo

application/json
customer_id
string
obrigatório

The customer this license key belongs to.

key
string
obrigatório

The license key string to import.

product_id
string
obrigatório

The product this license key is for.

activations_limit
integer<int32> | null

Maximum number of activations allowed. Null means unlimited.

expires_at
string<date-time> | null

Expiration timestamp. Null means the key never expires.

Resposta

License key created

brand_id
string
obrigatório

Brand id this license key belongs to

business_id
string
obrigatório

The unique identifier of the business associated with the license key.

created_at
string<date-time>
obrigatório

The timestamp indicating when the license key was created, in UTC.

Exemplo:

"2024-01-01T00:00:00.000Z"

customer_id
string
obrigatório

The unique identifier of the customer associated with the license key.

Exemplo:

"cus_123"

id
string
obrigatório

The unique identifier of the license key.

Exemplo:

"lic_123"

instances_count
integer<int32>
obrigatório

The current number of instances activated for this license key.

key
string
obrigatório

The license key string.

product_id
string
obrigatório

The unique identifier of the product associated with the license key.

source
enum<string>
obrigatório

The source of the license key - 'auto' for keys generated by payment/subscription flows, 'import' for merchant-imported keys.

Opções disponíveis:
auto,
import,
manual
status
enum<string>
obrigatório

The current status of the license key (e.g., active, inactive, expired).

Opções disponíveis:
active,
expired,
disabled
activations_limit
integer<int32> | null

The maximum number of activations allowed for this license key.

Exemplo:

5

expires_at
string<date-time> | null

The timestamp indicating when the license key expires, in UTC.

Exemplo:

"2024-12-31T23:59:59.000Z"

payment_id
string | null

The unique identifier of the payment associated with the license key, if any.

subscription_id
string | null

The unique identifier of the subscription associated with the license key, if any.

Última modificação em 6 de agosto de 2026