Customer data: `metadata`

The API has no fields for customer data and no way to prefill the checkout form: the customer enters their details on ROKI's page.

To carry your own information, use metadata, which comes back untouched on retrieval and in every webhook:

"metadata": { "order_id": "1001", "customer_email": "customer@example.com", "branch": "SPS" }

It is a channel between your system and ROKI: it is not shown to the customer. Use it to reconcile without depending solely on your own database.