Back to Docs

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

1. Create Link2. Share Link3. Customer Pays4. You Receive Funds
1

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 section
2

Create 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",
});
```
3

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 customers
4

Customer 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 sender
5

Verify 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 failed

Testing 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.

Learn more about Checkout Links