Skip to main content
POST
Inscrever cliente no produto

Autorizações

Authorization
string
header
obrigatório

Chave secreta da conta: Authorization: Bearer sk_test_… ou sk_live_…. Use só no servidor.

Cabeçalhos

Idempotency-Key
string

Chave única por operação (um UUID serve). Repetir com a mesma chave devolve a resposta original.

Parâmetros de caminho

productID
string<uuid>
obrigatório

ID do produto.

Corpo

application/json
externalId
string
obrigatório

O id deste cliente no seu sistema (por exemplo, o id do usuário no seu app). Obrigatório; repetir o mesmo valor devolve o mesmo cliente.

name
string | null

Nome do cliente.

email
string | null

E-mail do cliente.

taxId
string | null

CPF ou CNPJ.

pspRef
string | null

Referência do cliente no meio de pagamento, se você já tiver uma. Normalmente não é preciso enviar.

metadata
object

Dados livres seus, em JSON. Guardados na inscrição.

Resposta

Inscrição criada ou já existente.

Uma inscrição: este cliente neste produto. O id é o id da inscrição, que assinaturas, faturas, uso e saldos referenciam.

id
string<uuid>

Id da inscrição. É este que as chamadas de cobrança e de uso esperam.

customerId
string<uuid>

Id do cliente. Não use nas chamadas de cobrança e de uso; use id.

productId
string<uuid>
externalId
string

O id do cliente no seu sistema.

name
string | null
email
string | null
taxId
string | null

CPF ou CNPJ.

pspRef
string | null

Referência do cliente no meio de pagamento, quando existe.

metadata
object

Os dados livres enviados na inscrição.

creditAlertSent
boolean

Se o aviso de saldo baixo já foi enviado para esta inscrição.

createdAt
string<date-time>