Criar Assinatura
Assinaturas
Registra uma assinatura
Contrata uma assinatura de proteção mensal para o dispositivo do cliente
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.