The following web app is written in Node.js and shows how to integrate Keygen and Gumroad together using Gumroad's custom delivery fulfillment method. After a buyer purchases our software, we will create a license for the new customer and redirect them to a "success" page containing their license key and a download link to our product distributed using Keygen Dist.
Note: This integration requires that you have an upgraded Gumroad account in order to use their "Custom Delivery" method.
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 Gumroad API credentials (available under Settings->Advanced->Create Application)
export GUMROAD_ACCESS_TOKEN="YOUR_GUMROAD_ACCESS_TOKEN"
# 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 product to create licenses for and which product we'll
# be delivering download links for
export KEYGEN_PRODUCT_ID="YOUR_KEYGEN_PRODUCT_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 Gumroad product.
- Gumroad: add
https://{YOUR_NGROK_URL}/successas the redirect URL to your "Custom Delivery" product (more info)
Set up a Gumroad purchase form and create a test purchase.
Reach out at support@keygen.sh if you have any questions or concerns!