Skip to main content
POST
Criar Assinatura
string
required
Token de autenticação do tipo Bearer obtido através do endpoint de login.
integer
required
ID do plano de assinatura. Obtido via GET /plans.
integer
required
ID do cliente (segurado). Obtido via POST /customers ou GET /customers/{document}.
integer
required
ID do modelo do dispositivo a ser protegido. Obtido via GET /models.
string
IMEI ou número de série do dispositivo. Opcional na contratação — o cliente pode informar na vistoria pela área do segurado. Deve ser diferente de second_serial_number.
string
Segundo IMEI (para aparelhos dual-SIM). Opcional. Deve ser diferente de serial_number.
boolean
Indica se o dispositivo possui mais de 3 meses de uso. true ou false. Padrão: false.
integer
ID de uma sub-loja vinculada ao parceiro. Opcional — permite atribuir a contratação a uma filial específica. Obtido via GET /shopkeepers.
number
Valor do LMI (Limite Máximo de Indenização) desejado. Quando informado, a API verifica se o valor está dentro da faixa autorizada para o parceiro — se estiver, aplica; caso contrário, usa o padrão do modelo. Não gera erro se fora da faixa.
object
Metadados opcionais para rastreamento e atribuição da contratação.
string
Identificador da origem da contratação (ex: "app_ios", "pdv_sp_01", "ecommerce"). Máx. 100 caracteres.

Resposta

Retorna o recurso da assinatura criada.
A assinatura permanece em pending até que o pagamento da primeira parcela seja processado. Use GET /subscriptions/{id}/installments para listar as parcelas e POST /subscriptions/{id}/installments/{id}/notify-payment (gateway externo) ou POST /subscriptions/{id}/payment (gateway ClubFix) para ativar.

Authorizations

Authorization
string
header
required

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

Headers

Accept
string
required

Response

201 - application/json

Assinatura criada com sucesso