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"
}
}