Skip to content

Commit 406b26b

Browse files
committed
Eliminate overlap between When to Use and Common Scenarios
When to Use Checkout (refactored): - Point-of-Sale Payments (was Immediate Payments - clearer) - Payment Splitting (new - unique to checkout) - High-Volume Attribution (was E-commerce Scale + Order Attribution combined) - Conversion Payments (was Multi-Currency Support - more specific) Common Scenarios (trimmed): - Reduced each example to 1-2 sentences - Removed redundant details and numbers - Fixed inconsistent content Also removed: - Commerce escrow Info callout (unreleased feature)
1 parent 3d8968d commit 406b26b

File tree

1 file changed

+16
-20
lines changed

1 file changed

+16
-20
lines changed

use-cases/checkout.mdx

Lines changed: 16 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -138,48 +138,44 @@ Not sure which approach fits your needs? [See our detailed comparison of integra
138138
## When to Use Checkout
139139

140140
<CardGroup cols={2}>
141-
<Card title="Immediate Payments" icon="bolt">
142-
You need instant payment processing at the point of purchase - not invoices sent later
141+
<Card title="Point-of-Sale Payments" icon="bolt">
142+
You need instant payment processing during checkout - not invoices sent later for manual payment
143143
</Card>
144144

145-
<Card title="E-commerce Scale" icon="chart-line">
146-
Processing hundreds or thousands of orders per day where manual reconciliation doesn't work
145+
<Card title="Payment Splitting" icon="split">
146+
Revenue needs to be automatically distributed between multiple parties (vendors, platform fees, royalties)
147147
</Card>
148148

149-
<Card title="Order Attribution" icon="tag">
150-
Multiple customers paying similar amounts create attribution problems - you can't tell which payment is for which order
149+
<Card title="High-Volume Attribution" icon="chart-line">
150+
Processing many concurrent transactions where manual reconciliation or unique addresses per customer don't scale
151151
</Card>
152152

153-
<Card title="Multi-Currency Support" icon="coins">
154-
You want to accept many different tokens without managing separate payment processors or wallets for each
153+
<Card title="Conversion Payments" icon="exchange">
154+
You price in fiat but want customers to pay in crypto at current exchange rates
155155
</Card>
156156
</CardGroup>
157157

158158
## Common Scenarios
159159

160160
### Online Store Checkout
161-
Accept crypto payments for physical or digital products without generating unique addresses for each customer.
161+
Retailer processes thousands of daily orders with automatic payment attribution.
162162

163-
**Example:** An online retailer processes 5,000+ orders per day. Customers add items to cart and pay in crypto at checkout. Each order gets a unique Request ID - all payments go to a single wallet address, and every transaction is automatically matched to the correct order for instant fulfillment.
163+
**Example:** Customers pay in crypto at checkout, each order gets a unique Request ID for automatic matching to the correct order.
164164

165165
### Digital Goods & Services
166-
Sell software, digital content, or online courses with instant delivery upon payment confirmation.
166+
Marketplace sells design templates and fonts with instant delivery upon payment.
167167

168-
**Example:** A digital asset marketplace sells design templates, stock photos, and fonts. At checkout, customers pay in USDC and instantly receive download links. For recurring billing needs, see [Subscriptions use case](/use-cases/subscriptions).
168+
**Example:** Customer pays in USDC and instantly receives download links. For recurring billing, see [Subscriptions](/use-cases/subscriptions).
169169

170170
### Event Ticketing
171-
Process high-volume ticket sales with automatic ticket delivery and anti-fraud protection.
171+
Venue sells thousands of tickets with automatic NFT ticket delivery.
172172

173-
**Example:** A concert venue sells 10,000+ tickets. Each ticket purchase gets a unique Request ID. Upon payment confirmation, the system automatically generates and sends the ticket NFT or digital ticket to the customer's wallet.
173+
**Example:** Upon payment confirmation, system automatically generates and sends digital ticket to customer's wallet.
174174

175175
### Multi-vendor Marketplace
176-
Enable marketplace checkout where payments are automatically split between vendors and platform fees.
176+
NFT marketplace automatically splits payments between sellers, platform, and royalties.
177177

178-
**Example:** An NFT marketplace processes sales from hundreds of creators. At checkout, buyer pays once - Request Network automatically splits payment between seller (90%), platform fee (8%), and creator royalty (2%) using [batch payments](/api-features/batch-payments).
179-
180-
<Info>
181-
**Commerce escrow with fraud prevention** is in development for Base chain, enabling authorize-capture workflows with KYT (Know Your Transaction) checks. [Track progress →](https://github.com/RequestNetwork/requestNetwork/issues/1650)
182-
</Info>
178+
**Example:** Buyer pays once, Request Network splits payment between multiple recipients using [batch payments](/api-features/batch-payments).
183179

184180
## Key API Features for Checkout
185181

0 commit comments

Comments
 (0)