# 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.