Skip to content

Commit 5bb792d

Browse files
committed
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.
1 parent c24254f commit 5bb792d

File tree

1 file changed

+11
-11
lines changed

1 file changed

+11
-11
lines changed

use-cases/payment-detection.mdx

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -8,15 +8,15 @@ description: "Automatically detect and verify crypto payments with real-time blo
88

99
Traditional crypto payments lack business context. You receive a <Tooltip tip="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.
1010

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

1313
**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
1515
- **Multi-chain monitoring** - Track payments across 9 EVM chains in 150+ currencies
1616
- **Real-time notifications** - <Tooltip tip="HTTP callbacks that notify your server when payment events occur">Webhooks</Tooltip> for instant payment confirmations
1717
- **Zero manual work** - No spreadsheets, no guessing, no payment collisions
1818

19-
[See how payment references prevent payment collisions (welcome page demo) →](/use-cases/welcome)
19+
[See how Request IDs prevent payment collisions (welcome page demo) →](/use-cases/welcome)
2020

2121
## When to Use Payment Detection
2222

@@ -43,7 +43,7 @@ Request Network solves this with reference-based payment detection. Each request
4343
### Donations with Attribution
4444
Accept crypto donations to a single wallet and automatically attribute each to the correct donor, campaign, or cause.
4545

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

4848
### SaaS Adding Crypto Payments
4949
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
5353
### Manual Invoices with Crypto Settlement
5454
Send invoices through existing channels (email, PDF) and let customers pay in crypto with automatic detection.
5555

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 <Tooltip tip="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 <Tooltip tip="HTTP callbacks that notify your server when payment events occur">webhook</Tooltip>.
5757

5858
### High-Volume Payment Collection
5959
Collect thousands of payments without generating unique wallet addresses for each transaction.
6060

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

6363
<Info>
6464
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
6767
## How Payment Detection Works
6868

6969
<Steps>
70-
<Step title="Payment Reference Generated">
71-
When you create a request, a unique 16-character payment reference is automatically generated
70+
<Step title="Create Request">
71+
When you create a request, it gets a unique Request ID for tracking
7272
</Step>
7373

7474
<Step title="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
7676
</Step>
7777

7878
<Step title="Automatic Detection">
79-
Request Network monitors <Tooltip tip="Decentralized networks where cryptocurrency transactions are recorded">blockchains</Tooltip> for transactions containing your payment references
79+
Request Network monitors <Tooltip tip="Decentralized networks where cryptocurrency transactions are recorded">blockchains</Tooltip> and matches payments to your requests
8080
</Step>
8181

8282
<Step title="Get Notified">
83-
When a match is found, your request status updates and you receive a <Tooltip tip="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 <Tooltip tip="HTTP callback that notifies your server when payment events occur">webhook</Tooltip> notification
8484
</Step>
8585
</Steps>
8686

0 commit comments

Comments
 (0)