bountydotnew · ripgrim · Mar 10, 2026 · Mar 10, 2026 · Mar 10, 2026 · Mar 10, 2026
diff --git a/docs.json b/docs.json
@@ -14,10 +14,16 @@
     ],
     "groups": [
       {
-        "group": "Guides",
+        "group": "For creators",
         "pages": [
           "guides/creating-bounties",
-          "guides/payments"
+          "guides/funding-bounties"
+        ]
+      },
+      {
+        "group": "For developers",
+        "pages": [
+          "guides/solving-bounties"
         ]
-      {
-        "group": "For developers",
-        "pages": [
-          "guides/solving-bounties"
-        ]
+      {
+        "group": "For developers",
+        "pages": [
+          "guides/solving-bounties",
+          "guides/getting-paid"
+        ]
+      },
-      {
-        "group": "For developers",
-        "pages": [
-          "guides/solving-bounties"
-        ]
+      {
+        "group": "For developers",
+        "pages": [
+          "guides/solving-bounties",
+          "guides/getting-paid"
+        ]
+      },
       },
       {

diff --git a/guides/creating-bounties.mdx b/guides/creating-bounties.mdx
@@ -198,7 +198,7 @@
    Give enough time but create urgency.
  </Card>
  <Card title="Provide examples" icon="code">
    Share mockups, specs, or similar implementations.
  </Card>
  <Card title="Start small" icon="seedling">
    Test the platform with smaller bounties first.
@@ -225,10 +225,10 @@
 ## Next steps
 
 <CardGroup cols={2}>
-  <Card title="Set up integrations" icon="plug" href="/integrations/slack">
+  <Card title="Set up integrations" icon="plug" href="/integrations/github">
     Connect your favorite platforms.
   </Card>
-  <Card title="Payment settings" icon="credit-card" href="/guides/payments">
-    Configure payouts and billing.
+  <Card title="Funding bounties" icon="credit-card" href="/guides/funding-bounties">
+    Learn about payment methods and fees.
   </Card>
 </CardGroup>
diff --git a/guides/funding-bounties.mdx b/guides/funding-bounties.mdx
@@ -0,0 +1,202 @@
+---
+title: "Funding bounties"
+description: "How to fund bounties and manage payments as a creator"
+---
+
+## Overview
+
+Fund your bounties with a credit card and let bounty.new handle the rest. When you approve a submission, the developer gets paid instantly—no manual transfers, no hassle.
+
+## How it works
+
+<Steps>
+  <Step title="Create a bounty">
+    Set up your bounty with a clear description and reward amount.
+  </Step>
+  <Step title="Fund it">
+    Pay upfront with a credit card. Funds are held securely until work is approved.
+  </Step>
+  <Step title="Review submissions">
+    Developers submit solutions. You review and test their work.
+  </Step>
+  <Step title="Approve and pay">
+    When you approve a submission, the developer gets paid instantly.
+  </Step>
+</Steps>
+
+## Payment methods
+
+### Funding bounties
+
+- **Credit card**: Visa, Mastercard, American Express
+- **Instant processing**: Your bounty goes live immediately
+- **Secure**: All payments processed through Stripe
+
+<Note>
+  Bounties must be funded upfront. This ensures developers get paid immediately when their work is approved.
+</Note>
+
+## Fees and pricing
+
+### Platform fees
+
+| Fee type          | Amount      | When charged           |
+| ----------------- | ----------- | ---------------------- |
+| Platform fee      | 5%          | When bounty is created |
+| Card processing   | 2.9% + $0.30| When bounty is created |
+
+<Tip>
+  Developers receive 100% of the bounty amount. You pay the platform fee and processing fees upfront.
+</Tip>
+
+### Example calculation
+
+For a $500 bounty:
+
+```
+Bounty amount:        $500.00
+Platform fee (5%):    $ 25.00
+Card processing:      $ 15.20
+─────────────────────────────
+Total charged:        $540.20
+
+Developer receives:   $500.00
+```
+
+## Managing funded bounties
+
+### Approving work
+
+When you approve a submission:
+
+1. Developer receives the full bounty amount instantly
+2. Bounty is marked as complete
+3. You receive a receipt for your records
+
+### Cancelling and refunds
+
+#### Unfunded bounties
+
+Delete them directly—no refund needed since they weren't funded.
+
+#### Funded bounties
+
+To cancel a funded bounty:
+
+<Steps>
+  <Step title="Request cancellation">
+    Click **Request cancellation** from the bounty menu.
+  </Step>
+  <Step title="Provide reason (optional)">
+    Help us understand why you're cancelling.
+  </Step>
+  <Step title="Wait for refund">
+    Our team processes your refund manually.
+  </Step>
+  <Step title="Receive refund">
+    You'll receive the bounty amount minus the 5% platform fee.
+  </Step>
+</Steps>
+
+<Warning>
+  You cannot cancel a bounty that has an approved submission. Once work is approved, the developer must be paid. The 5% platform fee is non-refundable.
+</Warning>
+
+### Refund calculation
+
+For a $500 bounty:
+
+```
+Original amount:      $500.00
+Platform fee (5%):    $ 25.00 (non-refundable)
+─────────────────────────────
+Refund amount:        $475.00
+```
+
+### What happens during cancellation
+
+- All pending submitters receive a notification email
+- Bounty badge changes from "Funded" to "Cancelling"
+- Delete button becomes available while waiting for refund
+- Once refunded, bounty status changes to "Cancelled"
+
+## Payment security
+
+### How payment protection works
+
+1. **Funds secured**: When you fund a bounty, money is held securely in our platform account
+2. **Protected**: Neither party can access funds until work is approved
+3. **Released**: Funds transfer instantly to the developer upon approval
+4. **Refunded**: If cancelled, funds return to you (minus platform fee)
+
+### Dispute resolution
+
+If there's a disagreement with a developer:
+
+<Steps>
+  <Step title="Communicate directly">
+    Try to resolve the issue with the developer first.
+  </Step>
+  <Step title="Request mediation">
+    Contact [grim@bounty.new](mailto:grim@bounty.new) for help.
+  </Step>
+  <Step title="Review process">
+    Our team reviews the work and original requirements.
+  </Step>
+  <Step title="Fair decision">
+    Funds are released based on a fair assessment.
+  </Step>
+</Steps>
+
+<Warning>
+  Disputes are rare but taken seriously. Provide clear requirements upfront to avoid issues.
+</Warning>
+
+## Best practices
+
+<CardGroup cols={2}>
+  <Card title="Fund before promoting" icon="wallet">
+    Only share your bounty publicly after it's funded. Unfunded bounties can't accept submissions.
+  </Card>
+  <Card title="Set fair rewards" icon="scale">
+    Pay market rates for the work required. Higher rewards attract better developers.
+  </Card>
+  <Card title="Be responsive" icon="bolt">
+    Approve or provide feedback quickly. Developers appreciate fast turnaround.
+  </Card>
+  <Card title="Clear requirements" icon="list-checks">
+    Detailed requirements reduce disputes and lead to better submissions.
+  </Card>
+</CardGroup>
+
+## Troubleshooting
+
+<AccordionGroup>
+  <Accordion title="Payment method declined">
+    - Verify card details are correct
+    - Check with your bank for blocks or limits
+    - Try an alternative payment method
+    - Contact [grim@bounty.new](mailto:grim@bounty.new) if issue persists
+  </Accordion>
+  <Accordion title="Incorrect amount charged">
+    - Review the fee breakdown: bounty amount + 5% platform fee + card processing
+    - Check your transaction history for details
+    - Contact [grim@bounty.new](mailto:grim@bounty.new) if you believe there's an error
+  </Accordion>
+  <Accordion title="Refund not received">
+    - Refunds are processed manually and may take 3-5 business days
+    - Check that your cancellation request was submitted
+    - Contact [grim@bounty.new](mailto:grim@bounty.new) for status updates
+  </Accordion>
+  <Accordion title="Can't cancel bounty">
+    - Check if there's an approved submission (cannot cancel if approved)
+    - Make sure the bounty is funded (unfunded bounties can be deleted directly)
+    - Contact [grim@bounty.new](mailto:grim@bounty.new) for help
+  </Accordion>
+</AccordionGroup>
+
+## Need help?
+
+<Card title="Contact support" icon="headset" href="mailto:grim@bounty.new">
+  Questions about payments? Our team is here to help.
+</Card>
diff --git a/guides/getting-paid.mdx b/guides/getting-paid.mdx
@@ -0,0 +1,160 @@
+---
+title: "Getting paid"
+description: "How payouts work for bounty solvers"
+---
+
+## Overview
+
+Get paid instantly when your work is approved. No waiting periods, no hassle. Connect your Stripe account and receive 100% of the bounty amount directly to your bank.
+
+## Setting up payouts
+
+<Steps>
+  <Step title="Connect Stripe">
+    Go to [bounty.new/settings/payments](https://bounty.new/settings/payments) and click **Connect Stripe account**.
+  </Step>
+  <Step title="Complete verification">
+    Stripe will ask for basic information to verify your identity. This is required by financial regulations.
+  </Step>
+  <Step title="Add bank account">
+    Link your bank account to receive direct deposits.
+  </Step>
+  <Step title="Start solving">
+    Once connected, you can receive payments immediately upon approval.
+  </Step>
+</Steps>
+
+<Warning>
+  You must connect your Stripe account before a creator can approve your submission. Set this up first.
+</Warning>
+
+## How payouts work
+
+### Payment timeline
+
+<Steps>
+  <Step title="Submit solution">
+    You submit your work for a bounty.
+  </Step>
+  <Step title="Creator reviews">
+    The bounty creator reviews and tests your submission.
+  </Step>
+  <Step title="Approval">
+    Once approved, payment processes instantly.
+  </Step>
+  <Step title="Receive funds">
+    Money hits your Stripe account immediately—no waiting period.
+  </Step>
+</Steps>
+
+### Payout methods
+
+- **Direct bank transfer**: Funds deposited directly to your bank account
+- **Instant processing**: Payment processes the moment your submission is approved
+- **No fees**: You keep 100% of the bounty amount
+
+<Tip>
+  Developers pay zero fees. Creators cover the 5% platform fee, so you receive the full bounty amount.
+</Tip>
+
+## Payment details
+
+### What you receive
+
+For a $500 bounty:
+
+```
+Bounty amount:        $500.00
+Platform fee:         $  0.00 (paid by creator)
+Processing fee:       $  0.00 (paid by creator)
+─────────────────────────────
+You receive:          $500.00
+```
+
+### Bank transfer timing
+
+- **Instant to Stripe**: Funds available in your Stripe balance immediately
+- **Bank transfer**: 1-2 business days to reach your bank account
+- **No holds**: No waiting periods or payment holds
+
+## Troubleshooting
+
+<AccordionGroup>
+  <Accordion title="Can't connect Stripe account">
+    - Make sure you're in a supported country
+    - Verify your identity information is correct
+    - Check that you're using a valid bank account
+    - Contact [grim@bounty.new](mailto:grim@bounty.new) if issues persist
+  </Accordion>
+  <Accordion title="Payment not received">
+    - Check that your Stripe account is fully verified
+    - Bank transfers take 1-2 business days
+    - Verify your bank account details are correct
+    - Check your Stripe dashboard for pending transfers
+    - Contact [grim@bounty.new](mailto:grim@bounty.new) for help
+  </Accordion>
+  <Accordion title="Stripe verification failed">
+    - Double-check all information is accurate
+    - Ensure your documents are clear and valid
+    - Contact Stripe support for verification issues
+    - Reach out to [grim@bounty.new](mailto:grim@bounty.new) if stuck
+  </Accordion>
+  <Accordion title="Wrong amount received">
+    - Check the original bounty amount
+    - Verify there were no partial payments
+    - Review your Stripe transaction history
+    - Contact [grim@bounty.new](mailto:grim@bounty.new) if there's a discrepancy
+  </Accordion>
+</AccordionGroup>
+
+## Payment security
+
+### How we protect your money
+
+- **Escrow system**: Funds are held securely until work is approved
+- **Instant release**: Payment processes immediately upon approval
+- **Stripe powered**: All payments processed through Stripe's secure infrastructure
+- **No chargebacks**: Once approved, payment is final
+
+### Your protection
+
+- **Work first, then payment**: Only submit when you're confident in your solution
+- **Clear requirements**: Make sure you understand what's expected before starting
+- **Communication**: Keep the creator updated to avoid surprises
+- **Dispute resolution**: Contact [grim@bounty.new](mailto:grim@bounty.new) if there's an issue
+
+## Tax information
+
+<Note>
+  Bounty.new does not withhold taxes. You're responsible for reporting your earnings according to your local tax laws.
+</Note>
+
+### What you need to know
+
+- **Independent contractor**: You're paid as an independent contractor
+- **Tax forms**: Stripe may require tax information depending on your country
+- **Record keeping**: Keep track of your earnings for tax purposes
+- **Consult a professional**: Talk to a tax advisor about your specific situation
+
+## Maximizing your earnings
+
+<CardGroup cols={2}>
+  <Card title="Solve more bounties" icon="bolt">
+    The more quality work you deliver, the more you earn.
+  </Card>
+  <Card title="Build reputation" icon="star">
+    Consistent quality work leads to private bounty invitations.
+  </Card>
+  <Card title="Move fast" icon="rocket">
+    First quality submission often wins. Speed + quality = more earnings.
+  </Card>
+  <Card title="Communicate well" icon="comments">
+    Good communication leads to faster approvals and repeat work.
+  </Card>
+</CardGroup>
+
+## Need help?
+
+<Card title="Contact support" icon="headset" href="mailto:grim@bounty.new">
+  Questions about payouts? We're here to help.
+</Card>