Your First Payment
Walk through accepting your first crypto payment with Yeld.
Payment Flow Overview
From checkout link creation to receiving funds in your wallet
Navigate to Your Dashboard
Once you've created a business, you'll be redirected to your dashboard.
**Dashboard URL pattern:**
`/${bizId}/dashboard`
Where `bizId` is your unique business identifier (e.g., `biz_abc123def456`).
**What you'll see:**
- Available balance (in USD)
- Network selector (Base, Ethereum, etc.)
- Action buttons (Accept, Send, etc.)
- Recent activity feed
- Deposit address sectionCreate a Checkout Link
Checkout links are shareable payment URLs that customers can use to pay you.
**To create a checkout link:**
1. Click the "Accept" button or navigate to `/checkout-links/create`
2. Fill in the payment details:
- **Plan Name**: Display name for the payment (e.g., "Website Design")
- **Plan**: Internal identifier (e.g., "web-design")
- **Description**: Detailed description for customers
- **Price**: Amount in USD (e.g., "150.00")
- **Billing Type**: Recurring or One-Time
- **Initial Fee**: Optional upfront charge
- **Trial Days**: Optional free trial period
- **Stock**: Optional inventory limit
3. Click "Create Link"
4. Copy the generated link
**Example:**
```typescript
await createCheckoutLink("biz_abc123", {
planName: "Website Design Package",
plan: "web-design",
description: "Full website redesign with 5 pages",
price: "150.00",
billing: "one-time",
initialFee: "",
trial: "",
stock: "10",
});
```Share the Payment Link
Once created, share your checkout link with customers through any channel:
**Sharing Options:**
- **Direct URL**: Copy and paste the link
- **QR Code**: Generate a QR code for in-person payments
- **Email**: Send via email to customers
- **Social Media**: Share on Twitter, LinkedIn, etc.
- **Embed**: Add to your website as a button or widget
**Best Practices:**
- Use clear, descriptive plan names
- Include the price in the description
- Test the link before sharing with customersCustomer Makes Payment
Customers can pay using any supported wallet on the Base Sepolia network.
**Customer Payment Flow:**
1. Customer clicks your checkout link
2. They see the payment details (amount, plan name, description)
3. They connect their wallet (MetaMask, Rainbow, etc.)
4. They approve the USDC transfer
5. The transaction is processed on-chain
6. They receive a confirmation
**Minimum Requirements:**
- Customer must have USDC on Base Sepolia
- Customer needs a compatible wallet
- Network fee (gas) is paid by the senderVerify the Payment
After the customer sends payment, verify it was successful.
**Automatic Verification:**
- Transactions are automatically detected on-chain
- Status updates in real-time
- Email notifications (if configured)
**Manual Verification:**
1. Go to your dashboard
2. Check the "Activity" section
3. Look for the pending transaction
4. Verify the transaction hash on BaseScan
**Transaction Statuses:**
- `pending`: Transaction initiated, awaiting confirmation
- `verifying`: Being processed
- `confirmed`: Payment successful
- `expired`: Payment link expired
- `failed`: Transaction failedTesting on Testnet
During development, use Base Sepolia testnet to avoid real transactions.
Get Test USDC
- Visit the Base Sepolia faucet
- Request test USDC tokens
- Fund your test wallet
Important Notes
- Testnet tokens have no real value
- Testnet transactions don't incur real gas fees
- Always test on testnet before production
Security Best Practices
Verify Transaction Details
Always double-check the amount and recipient address before confirming any transaction.
Protect Your Private Keys
Never share your private keys or seed phrase. Yeld uses a non-custodial model—your keys stay on your server.
Monitor Your Transactions
Regularly check your dashboard for unusual activity. Set up webhooks for real-time alerts.
Troubleshooting
Payment not showing in dashboard?
Check the transaction hash on BaseScan. If the transaction is confirmed but not showing, allow up to 2 minutes for processing.
Getting a "transaction failed" error?
This usually means insufficient funds or the wrong token was sent. Ensure you have USDC on the correct network.
Can I accept payments in other tokens?
Currently, Yeld accepts USDC on supported networks. Additional token support is coming soon.