Customizing Stripe for Your Token on Spawned
This guide details the process for developers to customize Stripe payment integrations for Solana tokens launched via Spawned. We cover fee adjustments, webhook configurations, and UI/UX branding options specific to token sales and purchases. Proper setup ensures you capture the full 0.30% creator revenue and integrate holder rewards seamlessly.
Try It NowKey Benefits
The Problem
Traditional solutions are complex, time-consuming, and often require technical expertise.
The Solution
Spawned provides an AI-powered platform that makes building fast, simple, and accessible to everyone.
Why Customization is Required for Token Payments
Out-of-the-box Stripe won't cut it for crypto.
Using Stripe's default settings for a standard e-commerce store isn't suitable for token transactions on Spawned. Token sales have unique requirements: instant digital asset delivery, integration with on-chain wallets, and alignment with Spawned's specific fee model (0.30% creator fee, 0.30% holder rewards). Without customization, you risk payment failures, incorrect fee calculations, and a disjointed user experience. Our recommendation: Dedicate time to configure Stripe specifically for your token's launch parameters.
Step 1: Access and Connect Your Stripe Account
Prerequisite: You must have launched your token on Spawned (0.1 SOL fee) and have a Stripe account.
- Log into your Spawned creator dashboard.
- Navigate to the 'Monetization' or 'Payments' section.
- Click 'Connect Stripe'. This will redirect you to Stripe's OAuth page.
- Authorize Spawned to access necessary payment endpoints. Critical: Ensure you grant permissions for
chargesandwebhooks. - Upon successful connection, you'll be redirected back to Spawned. Your Stripe Account ID will now be linked to your token project.
This connection is the foundation for all subsequent customization.
Core Configuration: Fees, Webhooks, & Compliance
The behind-the-scenes setup that makes everything work.
This is the most technical and crucial part of the setup. Misconfiguration here leads to lost revenue or compliance issues.
- Fee Structure: In your Stripe dashboard, create a new Product for your token. Under Pricing, set the amount. You must factor in Spawned's 0.30% creator fee on trades. While Stripe's fee is ~2.9% + $0.30, you need to ensure your token price covers this and Spawned's cut for a sustainable model. Example: For a $10 token purchase, ~$0.33 goes to fees (Stripe + Spawned).
- Webhook Endpoint: In Stripe's Developers > Webhooks section, add an endpoint URL. Spawned provides this in your dashboard (e.g.,
https://api.spawned.com/webhooks/stripe/[YOUR_TOKEN_ADDRESS]). Configure it to listen forcheckout.session.completedandpayment_intent.succeededevents. This tells Spawned when to release tokens to the buyer's wallet. - Compliance & Statements: Under Settings > Branding, ensure your statement descriptor is clear (e.g., 'SPAWNEDTOKEN*PURCHASE'). This reduces customer disputes. Enable radar rules for fraud detection, especially important for digital goods like tokens.
Customizing the Checkout Experience
A generic checkout page creates friction. You want the payment flow to feel like a native part of your token project. After connecting Stripe via Spawned, you can customize the hosted checkout page.
Log into your Stripe dashboard and go to Settings > Branding. Here, you can upload your token's logo, which will appear on the payment form. Set the primary color to match your token's or website's theme. More importantly, you can edit the payment description and customer-facing messaging. Instead of 'Product 1234,' it should read 'Purchase of 100 [YOURTOKEN] Tokens.'
You can also configure post-payment behavior. Set a Success Redirect URL to a specific page on the AI-built website that Spawned helped you create, such as a 'Thank You' page with next steps for the new token holder. This guides users back into your ecosystem, increasing engagement and supporting the holder reward mechanism.
Spawned Integration vs. A Generic Stripe Setup
Why the Spawned path is more efficient.
| Feature | Spawned-Guided Stripe Setup | Generic Stripe Setup |
|---|---|---|
| Fee Awareness | Automatically accounts for the 0.30% creator fee and 1% post-graduation fee structure. | Unaware of blockchain fees; can lead to incorrect profit calculations. |
| Token Delivery | Webhooks pre-configured to trigger immediate token transfer to the buyer's Solana wallet. | No automatic digital asset delivery; requires manual fulfillment. |
| Holder Rewards | Payment data can be linked to reward distribution for the 0.30% ongoing holder program. | No connection to on-chain reward systems. |
| AI Website Link | Seamless redirect to your Spawned-built website post-purchase. | Redirects to a generic success page. |
| Support | Access to support familiar with both Stripe and Solana token mechanics. | Standard Stripe support, no crypto-specific knowledge. |
The integrated approach saves development time and reduces points of failure.
Step 2: Test Thoroughly Before Launch
Never go live without testing. Stripe provides a full sandbox environment.
- In the Stripe dashboard, toggle to Test Mode.
- Use Stripe's provided test card numbers (e.g.,
4242 4242 4242 4242) to simulate a purchase of your token. - Monitor the webhook logs in both Stripe and your Spawned dashboard to confirm the
payment_intent.succeededevent is received and processed. - Verify that test tokens are sent to your designated test wallet address. Important: No real SOL or tokens should move in test mode.
- Test the full user journey: click 'Buy Token' on your site, go through the custom checkout, complete payment, and land on your thank-you page.
Only switch to Live Mode after 5-10 successful test transactions with zero errors in the logs.
Ready to Launch with Custom Payments?
Customizing Stripe is the final step in professionalizing your token's monetization path. It ensures you reliably collect your 0.30% creator revenue from every trade and provide a smooth fiat on-ramp for your community.
If you haven't launched your token yet, start with the AI website builder and pay the 0.1 SOL launch fee. Then, return to this guide to set up payments.
Next Step: Connect your Stripe account in your Spawned dashboard and begin the customization process outlined above.
Related Topics
Frequently Asked Questions
Currently, Spawned's integrated fiat on-ramp is built on Stripe for its reliability and global reach. This guide is specific to that integration. Using another processor would require a custom, self-built solution outside of Spawned's automated token distribution system, which is not recommended for most creators.
This is why webhook configuration is critical. Spawned's system is designed to release tokens only upon receiving a confirmed `payment_intent.succeeded` event from Stripe. If a payment fails (e.g., card decline), Stripe does not send this success event, so tokens are not released. The order state is 'failed' in both systems.
They are separate. Stripe charges its standard processing fee (~2.9% + $0.30) on the fiat transaction. Spawned's 0.30% creator fee is applied later, on subsequent trades of the token on the open market. When setting your token's purchase price via Stripe, you should account for Stripe's fee to ensure you net your desired amount.
Yes, Stripe supports subscriptions. In your Stripe product settings, select 'Recurring' pricing. You would then need to work with Spawned's system (potentially via custom webhook logic) to schedule recurring token distributions (e.g., for a membership token). This is an advanced use case beyond basic one-time purchase setup.
After connecting Stripe, navigate to your token's project page in the Spawned creator dashboard. Look for a 'Webhooks' or 'Integration' tab. Your unique, pre-generated webhook endpoint URL will be displayed there. Copy and paste this exact URL into Stripe's webhook configuration panel.
For the basic integration described in this guide, no. Spawned handles the server-side logic for listening to webhooks and distributing tokens. Your work is configuration within the Stripe and Spawned dashboards. Writing custom code is only necessary for highly advanced modifications to the payment flow.
Spawned only receives the minimum data required to fulfill the order: the transaction ID, amount, currency, and the customer's provided Solana wallet address (collected on the checkout page). Spawned does not store or receive sensitive payment information like full credit card numbers.
Ready to get started?
Join thousands of users who are already building with Spawned. Start your project today - no credit card required.