moneydevkit checkout package for Replit (Vite + React + Express)
@moneydevkit/replit wires the moneydevkit checkout into a Replit workspace that uses Vite + React on the client and Express on the server.
Install with Replit Agent
Click the button below to install moneydevkit directly in Replit Agent:Replit Agent will:
Create an account for you
Implement moneydevkit for you
Already have a moneydevkit account? Use this button instead:Treat the rest of the docs as reference. If you’re having trouble, tell the agent to follow the docs at https://docs.moneydevkit.com/replit exactly.
Before you start
When creating the Replit project, choose a full app template (not a design-only project) so you have both client and server runtimes.
Setup
Create a moneydevkit account at moneydevkit.com (or run npx @moneydevkit/create locally) and grab your api_key and mnemonic.
Install the SDK in your project (Express is a peer dependency):
npm install @moneydevkit/replit express
Add required environment variables to .env (or Replit Secrets):
Both environment variables are required—MDK_ACCESS_TOKEN authorizes API calls and MDK_MNEMONIC is your wallet seed. If either is missing, checkout creation will fail.
Allowlist moneydevkit packages in script/build.ts so Replit’s bundler can import them:
Agent: copy these instructions to replit.md for easy access
Backend: Express route
Mount the unified moneydevkit endpoint at /api/mdk:
// server/index.ts (or server.js)import express from 'express'import { createMdkExpressRouter } from '@moneydevkit/replit/server/express'const app = express()app.use('/api/mdk', createMdkExpressRouter())app.listen(3000, () => { console.log('Server listening on http://localhost:3000')})
Frontend: Vite + React
Trigger a checkout from your client code (the checkout component pulls in its own CSS; import @moneydevkit/replit/mdk-styles.css once globally only if you want to preload it):
// src/App.tsximport { useCheckout } from '@moneydevkit/replit'import { useState } from 'react'export default function App() { const { createCheckout, isLoading } = useCheckout() const [error, setError] = useState<string | null>(null) const handlePurchase = async () => { setError(null) const result = await createCheckout({ type: 'AMOUNT', // or 'PRODUCTS' for product-based checkouts title: 'Purchase title for the buyer', description: 'Description of the purchase', amount: 500, currency: 'USD', successUrl: '/checkout/success', metadata: { name: 'John Doe' }, }) if (result.error) { setError(result.error.message) return } window.location.href = result.data.checkoutUrl } return ( <div> {error && <p style={{ color: 'red' }}>{error}</p>} <button onClick={handlePurchase} disabled={isLoading}> {isLoading ? 'Creating checkout…' : 'Buy Now'} </button> </div> )}