Dashboard Overview
Total Customers
Total Products
Active Tokens
Locked Tokens
| Name | Products | Created | Actions |
|---|
| Cover | Name | Type | URL | Created | Actions |
|---|
| Customer | Product | Token | Status | Created | Actions |
|---|
Generated Wrappers
A wrapper is an HTML page that contains an embedded access token. When customers open the wrapper, it automatically verifies their access. If they have access, the content is displayed. If you revoke access, the wrapper will deny them entry.
đ How it works:
1. Create a Customer in the Customers section
2. Create a Product Token for that customer in the Products section
3. Generate a Wrapper (PDF or Video type) using that token
4. Download the wrapper HTML file (available in the table below)
5. Open the wrapper in your browser OR share the wrapper URL with your customer
6. The wrapper verifies the token - if valid, content is shown; if revoked, access denied
đĄ Key Features:
- The wrapper contains a unique access token for each customer
- Lock/unlock a token to instantly revoke or grant access
- Track downloads in the Wrappers table
- Share wrapper HTML file or link with customers
| Customer | Product | Type | Created | Opens | Actions |
|---|
Wrappers Generated
Total Downloads
Access Checks
Locked Licenses
Recent Access Log
| Customer | Product | Status | IP | When |
|---|
Alerts
Loading alerts...
Account Settings
Your unique account identifier. Keep this private.
Token Verify Endpoint
Use this if you are building your own integration outside of a wrapper. Make a POST request with {"token":"pk_..."} in the body. The response tells you whether the token is active or locked.
curl -X POST \
-H "Content-Type: application/json" \
-d '{"token":"pk_YOUR_TOKEN"}'
Stripe Webhook URL
Add this URL in your Stripe Dashboard â Developers â Webhooks â Add endpoint. Select these events:
checkout.session.completedâ auto-delivers your product when a customer buyscharge.refundedâ automatically revokes access when a refund is issued
After adding the endpoint, Stripe will show you a Signing Secret (starts with whsec_). Enter it below so PayLocker can verify the webhook is genuine.
Automated Delivery Setup
When a customer completes a purchase, PayLocker will automatically add them, create their access token, generate their wrapper, and email them a personal access link â with no action needed from you.
One setup step: On each Stripe product or Checkout Session you create, add a metadata field:
metadata: {
paylocker_product_id: 'paste-your-product-id-here'
}
Find your Product IDs in the Products section â click Copy ID next to any product. Without this, PayLocker will send you a manual alert instead.
How to Pass the Token to Stripe (for Refund Locking)
PayLocker identifies which token to lock by reading metadata.paylocker_token from the Stripe charge. Without it, no token is locked and you receive an alert to lock manually. Here is how to set it for the most common Stripe integration methods:
âļ Stripe API / Payment Intents (recommended)
When creating a PaymentIntent or Charge via the Stripe API, include metadata with the PayLocker token:
stripe.paymentIntents.create({
amount: 4900,
currency: 'usd',
customer: stripeCustomerId,
metadata: {
paylocker_token: 'pk_abc123...' // token from PayLocker
}
});
The token is available in the PayLocker dashboard under Licenses after you create it for a customer.
âļ Stripe Checkout Sessions
When creating a Checkout Session, add payment_intent_data.metadata:
stripe.checkout.sessions.create({
mode: 'payment',
line_items: [...],
payment_intent_data: {
metadata: {
paylocker_token: 'pk_abc123...'
}
},
success_url: 'https://yoursite.com/success',
cancel_url: 'https://yoursite.com/cancel'
});
Note: metadata on the Session itself is not passed to the charge â it must be on payment_intent_data.
âļ Stripe Payment Links (workaround)
Payment Links do not support custom metadata on individual sales. The recommended workaround is to use a Zapier or Make.com automation:
- Trigger: Stripe â New Charge (or New Payment)
- Filter by the product/price ID to identify which PayLocker token to use
- Action: Stripe â Update Charge â add
metadata.paylocker_token
Alternatively, avoid Payment Links for products that use PayLocker and use Checkout Sessions instead â they give you full metadata control.