Metadata

A maioria dos nossos objetos - como Customer, card, address subscription, plan, order, charge e invoice - possuem o parâmetro metadata, pelo qual você consegue armazenar dados chave-valor.

Metadados são interessantes para o armazenamento estruturado de dados complementares relacionados a algum objeto. Um exemplo seria adição do nome do pai de um cliente para ter essa informação em sua carteira de clientes.

{
  ...
  "metadata": {
    "meu_campo1": "valor1",
    "meu_campo2": "valor2"
  }
}