You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Use Request ID terminology throughout Use Case page (Option A)
Strategy: Use Case page uses user-facing 'Request ID' abstraction, API Features page will explain 'Payment Reference' implementation details.
Changes:
- Overview: Request IDs attach business context (not payment references)
- Steps: Request ID is automatically embedded (abstracts payment reference mechanism)
- Examples: All use 'Request ID' consistently
- Maintains consistency with Welcome page vocabulary
- Links to API Features page for technical deep dive
Terminology strategy:
- Request ID = user-facing identifier users interact with
- Payment Reference = 16-char derived identifier for smart contracts
- API Features page will explain the derivation and correlation
- Use Case page focuses on what/why, not how
This maintains technical accuracy while providing appropriate abstraction level for use case documentation.
Copy file name to clipboardExpand all lines: use-cases/payment-detection.mdx
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,15 +8,15 @@ description: "Automatically detect and verify crypto payments with real-time blo
8
8
9
9
Traditional crypto payments lack business context. You receive a <Tooltiptip="Unique identifier of a transaction recorded on the blockchain">transaction hash</Tooltip>, but don't know which customer, invoice, or order it's for. Manual reconciliation is error-prone and doesn't scale.
10
10
11
-
Request Network solves this with reference-based payment detection. Each request automatically generates a unique payment reference—a 16-character identifier included in the blockchain transaction. This connects every payment back to your specific invoice, order, or subscription with cryptographic certainty.
11
+
Request IDs solve this by attaching business context to every payment. Each request gets a unique Request ID that connects payments back to your specific invoice, order, or subscription with cryptographic certainty.
12
12
13
13
**What you get:**
14
-
-**Automatic attribution** - Every payment linked to its request via payment reference
14
+
-**Automatic attribution** - Every payment linked to its request via Request ID
15
15
-**Multi-chain monitoring** - Track payments across 9 EVM chains in 150+ currencies
16
16
-**Real-time notifications** - <Tooltiptip="HTTP callbacks that notify your server when payment events occur">Webhooks</Tooltip> for instant payment confirmations
17
17
-**Zero manual work** - No spreadsheets, no guessing, no payment collisions
@@ -43,7 +43,7 @@ Request Network solves this with reference-based payment detection. Each request
43
43
### Donations with Attribution
44
44
Accept crypto donations to a single wallet and automatically attribute each to the correct donor, campaign, or cause.
45
45
46
-
**Example:** A nonprofit collects donations from hundreds of donors to one Ethereum address. Each donation includes a unique payment reference, enabling automatic attribution and thank-you emails.
46
+
**Example:** A nonprofit collects donations from hundreds of donors to one Ethereum address. Each donation is linked to a unique Request ID, enabling automatic attribution and thank-you emails.
47
47
48
48
### SaaS Adding Crypto Payments
49
49
Add crypto as a payment option to existing subscription or billing platforms alongside credit cards.
@@ -53,12 +53,12 @@ Add crypto as a payment option to existing subscription or billing platforms alo
53
53
### Manual Invoices with Crypto Settlement
54
54
Send invoices through existing channels (email, PDF) and let customers pay in crypto with automatic detection.
55
55
56
-
**Example:** A freelancer emails invoices as PDFs with a payment reference. Clients include the reference when paying in crypto, and the freelancer's accounting software automatically marks invoices as paid via <Tooltiptip="HTTP callbacks that notify your server when payment events occur">webhook</Tooltip>.
56
+
**Example:** A freelancer emails invoices as PDFs with a Request ID. When clients pay in crypto, the freelancer's accounting software automatically marks invoices as paid via <Tooltiptip="HTTP callbacks that notify your server when payment events occur">webhook</Tooltip>.
57
57
58
58
### High-Volume Payment Collection
59
59
Collect thousands of payments without generating unique wallet addresses for each transaction.
60
60
61
-
**Example:** An e-commerce platform processes 10,000+ crypto orders per day. Instead of unique addresses, each order gets a unique payment reference for attribution.
61
+
**Example:** An e-commerce platform processes 10,000+ crypto orders per day. Instead of unique addresses, each order gets a unique Request ID for attribution.
62
62
63
63
<Info>
64
64
These scenarios all use automatic payment detection. [See technical details on detection methods and configuration →](/api-features/payment-detection)
@@ -67,20 +67,20 @@ These scenarios all use automatic payment detection. [See technical details on d
67
67
## How Payment Detection Works
68
68
69
69
<Steps>
70
-
<Steptitle="Payment Reference Generated">
71
-
When you create a request, a unique 16-character payment reference is automatically generated
70
+
<Steptitle="Create Request">
71
+
When you create a request, it gets a unique Request ID for tracking
72
72
</Step>
73
73
74
74
<Steptitle="Customer Pays">
75
-
Customer sends payment to your wallet address including the payment reference in the transaction
75
+
Customer sends payment to your wallet address - the Request ID is automatically embedded
76
76
</Step>
77
77
78
78
<Steptitle="Automatic Detection">
79
-
Request Network monitors <Tooltiptip="Decentralized networks where cryptocurrency transactions are recorded">blockchains</Tooltip> for transactions containing your payment references
79
+
Request Network monitors <Tooltiptip="Decentralized networks where cryptocurrency transactions are recorded">blockchains</Tooltip> and matches payments to your requests
80
80
</Step>
81
81
82
82
<Steptitle="Get Notified">
83
-
When a match is found, your request status updates and you receive a <Tooltiptip="HTTP callback that notifies your server when payment events occur">webhook</Tooltip> notification
83
+
When a payment is matched, your request status updates and you receive a <Tooltiptip="HTTP callback that notifies your server when payment events occur">webhook</Tooltip> notification
0 commit comments