Skip to content

Commit c24254f

Browse files
committed
Fix technical accuracy: use payment reference instead of Request ID
- Update Overview to explain reference-based payment detection - Clarify that 16-character payment reference is included in transactions, not Request ID - Update 'How Payment Detection Works' steps to reflect actual technical flow - Update all examples to use 'payment reference' terminology consistently - Maintain simplified language while being technically accurate Based on official docs: https://docs.request.network/request-network-api/payment-detection.md
1 parent d511757 commit c24254f

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 IDs solve this by attaching business context directly to payments. Every payment includes a unique Request ID, enabling automatic attribution and reconciliation with cryptographic certainty.
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.
1212

1313
**What you get:**
14-
- **Automatic attribution** - Every payment linked to its request (invoice, order, subscription)
14+
- **Automatic attribution** - Every payment linked to its request via payment reference
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 Request IDs prevent payment collisions (welcome page demo) →](/use-cases/welcome)
19+
[See how payment references prevent payment collisions (welcome page demo) →](/use-cases/welcome)
2020

2121
## When to Use Payment Detection
2222

@@ -43,7 +43,7 @@ Request IDs solve this by attaching business context directly to payments. Every
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 Request ID, enabling automatic attribution and thank-you emails.
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.
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 Request ID. Clients pay 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 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>.
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 Request ID for attribution.
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.
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="Create Request">
71-
Generate a unique Request ID when creating an invoice, order, or payment request
70+
<Step title="Payment Reference Generated">
71+
When you create a request, a unique 16-character payment reference is automatically generated
7272
</Step>
7373

7474
<Step title="Customer Pays">
75-
Customer sends payment to your wallet address - the Request ID is included in the transaction
75+
Customer sends payment to your wallet address including the payment reference in the transaction
7676
</Step>
7777

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

8282
<Step title="Get Notified">
83-
Your system receives a <Tooltip tip="HTTP callback that notifies your server when payment events occur">webhook</Tooltip> confirming the payment
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
8484
</Step>
8585
</Steps>
8686

0 commit comments

Comments
 (0)