Store custom key-value pairs on transfers to track your own references like invoice IDs, customer IDs, or order numbers. Use metadata to connect transfers with your internal systems for reconciliation, reporting, and business intelligence.
Constraints and limitations
Property
Constraint
Maximum key-value pairs
50 per transfer
Maximum key length
40 characters
Maximum value length
500 characters
Immutable
Yes (cannot be updated or deleted)
Searchable/filterable
No
Included in webhook events
No
Never store sensitive data like passwords, account numbers, or PII in metadata.
Usage
To add metadata, send your key-value pairs when using Create a Transfer. Include the optional metadata field in your request body.Request: