Customer data: metadata

The customer's details are entered on ROKI's page. You can prefill the ones you already know with the customer object and pin them with lock_customer_fields (7.5), but that object carries only name, email, phone and identity_number - there is no field for anything else about the customer.

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.