docs(x402): clarify the payment signature is reusable until balance runs out#2618
Merged
Conversation
Contributor
|
🗑️ Preview for this PR was deleted. |
marcel-rbro
requested changes
Jun 9, 2026
|
|
||
| :::note Reuse the same signature | ||
|
|
||
| The signed `PAYMENT-SIGNATURE` stays valid while your prepaid balance lasts. Send it with every subsequent request - each call draws from the balance with no new signing and no new on-chain settlement. When the balance is exhausted, the API responds with `402` again; repeat step 2 to sign a fresh payment and continue. |
Contributor
There was a problem hiding this comment.
repeat step 2 to sign a fresh payment and continue
I'd specify what you need to do: "Sign the payment again to continue."
Also, consider moving the entire note to the How it works section instead of the example.
Contributor
Author
There was a problem hiding this comment.
Done in 6d9e0d9 — moved the note up into the direct-API How it works section and reworded the last sentence to "sign the payment again to continue."
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Context
The x402 page doesn't state that the signed
PAYMENT-SIGNATUREcan be reused across calls. A reader following the direct-API steps may assume each call needs a fresh signature and a new on-chain settlement.Solution
:::notein the direct-API section: the samePAYMENT-SIGNATUREstays valid while the prepaid balance lasts; resend it on every call with no re-signing or new settlement, and only sign again when the API returns402(balance exhausted) — the manual equivalent of whatmcpcdoes automatically on the MCP path.