Als je metadata gebruikt kun je waarden naar keuze koppelen aan de meeste Stripe-objecten met behulp van het dashboard en via de API. Metadata kunnen op een object worden weergegeven als een groep combinaties van sleutels en waarden:

{
"customer_name": "John Doe",
"internal_customer_id": "1231235555",
"phone_number": "555-111-555"
}

In dit voorbeeld bevatten de metadata drie paren, met de sleutel aan de linkerkant en de bijbehorende waarde aan de rechterkant. Zoals je kunt zien, zijn metadata nuttig om alle verschillende typen data op te slaan die relevant kunnen zijn voor het object of voor je bedrijf.

Beperkingen van metadata

• Metadata accepteren alleen strings voor zowel sleutels als waarden
• Je kunt maximaal 50 sleutels hebben
• Sleutels kunnen maximaal 40 tekens bevatten
• Waarden kunnen maximaal 500 tekens bevatten

Wat als ik meer dan 50 metadatasleutels nodig heb?

Als je meer dan 50 metadatasleutels nodig hebt, wordt het aanbevolen om meer informatie onder één sleutel op te slaan. Aangezien de waarde van alles kan zijn, kun je de informatie opslaan als gestructureerde gegevens, mogelijk met behulp van JSON, dat je serialiseert naar een string.

Dit is bijvoorbeeld waar je de verzendgegevens kunt opslaan, met slechts één sleutel.

{
'shipping_address': '{"line1":"18th street","city":"San Francisco","zip":"94110","state":"CA","country":"US"}'
}