# Create a nonce
POST https://kanuu.io/api/nonce
Creates a Kanuu redirect URL for the provided identifier using a secure token that can be used only once.
# Body
Attribute | Validation | Description |
---|---|---|
identifier | required string | A unique identifier of your billable entity. For example, if you are creating subscriptions for users, then this could be your user ID. If you are creating subscriptions for teams, then it could be your team ID. |
email | optional type:email | An email address for your customer, used to prepopulate the Paddle checkout. This email address is encrypted at rest and only decrypted for your customers' use. |
supplemental | optional array max_length:16 | An array of key:value pairs. This additional set of supplemental information is passed to Paddle as passthrough data which you can then receive within your webhooks. |
supplemental.* | string max_length:64 |
# Request
Make the request by passing the identifier
as a data attribute and authenticate your application by providing your API key as a Bearer token.
# Response
If everything went well, you will receive a nonce
and a url
generated using this nounce. You can use this URL to securely redirect your users to Kanuu.
If you've not yet subscribed to Kanuu and reached more than 20 active customers, then you will receive a 402
asking you to subscribe to Kanuu to continue.