The following web app is written in Node.js and shows how to integrate Keygen and SendOwl together using SendOwl's "from URL" license key generation option.
This example application is not 100% production-ready, but it should get you 90% of the way there. You may need to add additional logging, error handling, validation, features, etc.
First up, configure a few environment variables:
# Your SendOwl API key (available under Settings->Advanced->API)
export SENDOWL_API_KEY="YOUR_SENDOWL_API_KEY"
# Your SendOwl API secret (available under Settings->Advanced->API)
export SENDOWL_API_SECRET="YOUR_SENDOWL_API_SECRET"
# Keygen product token (don't share this!)
export KEYGEN_PRODUCT_TOKEN="YOUR_KEYGEN_PRODUCT_TOKEN"
# Your Keygen account ID
export KEYGEN_ACCOUNT_ID="YOUR_KEYGEN_ACCOUNT_ID"
# The Keygen policy to use when creating licenses for new customers
# after they successfully purchase your product
export KEYGEN_POLICY_ID="YOUR_KEYGEN_POLICY_ID"You can either run each line above within your terminal session before
starting the app, or you can add the above contents to your ~/.bashrc
file and then run source ~/.bashrc after saving the file.
Next, install dependencies with yarn:
yarn
Then start the app:
yarn start
For local development, create an ngrok tunnel:
ngrok http 8080
Next up, add the secure ngrok URL to your license-key enabled SendOwl product.
- SendOwl: add
https://{YOUR_NGROK_URL}/sendowl-webhook?order_id={{order.id}}as the license key "from URL" to your product (note the liquid URL parameter, which is required! More info.)
Set up a SendOwl purchase form and create a test purchase.
Reach out at support@keygen.sh if you have any questions or concerns!