FAQ

The questions that come up while integrating, answered against what the platform does today.

Where do I get an API key?

In the console, under Settings. It is shown once and belongs to one organisation. See Authentication.

Is there an SDK?

Is there a sandbox?

There is no separate sandbox host. What integrations do instead is work against a template of their own in the same organisation, issue to a subject they control, and revoke it — the lifecycle is the same, and a revoked test credential leaves an honest trail rather than a parallel world that behaves slightly differently.

Why can I not set the fields when issuing?

Because the template decides what a credential says, and each field names a path on the subject. Update the subject and every credential they hold follows. It is the difference between a credential that tracks a record and one that froze a copy of it.

I issued a credential and the channels say `pending`.

That is correct. Signing an Apple pass and creating a Google Wallet object happen after the response. Wait for credential.channel.provisioned, or read the credential again — do not poll in a tight loop.

Do I define the pass twice?

No. One template, both wallets. Ask for both in channels and each is rendered in its own way.

Does the credential holder need an account?

No. They add the credential to a wallet that is already on their phone. There is no Nomi app for them to install and no password for them to remember.

Can I have the OpenAPI document?

Yes — it is versioned with the service and handed to customers who integrate against it, with your account's details already correct. It is not served publicly. Ask through the Help Center.