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
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
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 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.
12
12
13
13
**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
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 IDs solve this by attaching business context directly to payments. Every
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 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.
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 Request ID. Clients pay 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 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>.
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 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.
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="Create Request">
71
-
Generate a unique Request ID when creating an invoice, order, or payment request
70
+
<Steptitle="Payment Reference Generated">
71
+
When you create a request, a unique 16-character payment reference is automatically generated
72
72
</Step>
73
73
74
74
<Steptitle="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
76
76
</Step>
77
77
78
78
<Steptitle="Automatic Detection">
79
-
Request Network monitors the <Tooltiptip="Decentralized networks where cryptocurrency transactions are recorded">blockchain</Tooltip> and matches the payment to your request
79
+
Request Network monitors <Tooltiptip="Decentralized networks where cryptocurrency transactions are recorded">blockchains</Tooltip> for transactions containing your payment references
80
80
</Step>
81
81
82
82
<Steptitle="Get Notified">
83
-
Your system receives a <Tooltiptip="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 <Tooltiptip="HTTP callback that notifies your server when payment events occur">webhook</Tooltip> notification
0 commit comments