Skip to content

docs(payments): remove stale post-T6 callout, document held payments inline - #874

Open
max-digi wants to merge 1 commit into
mainfrom
docs/receive-policies-live-send-accept
Open

docs(payments): remove stale post-T6 callout, document held payments inline#874
max-digi wants to merge 1 commit into
mainfrom
docs/receive-policies-live-send-accept

Conversation

@max-digi

@max-digi max-digi commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

Why

The warning at the top of Send a Payment opens with "On post-T6 networks…". T6 has been active on testnet and mainnet since June 2026 (see T6 Network Upgrade), so the conditional framing is stale. This was the last post-T6 conditional in the guides.

The behavior the callout describes is permanent, so rather than delete the guidance this PR removes the callout and moves the content to where readers act on it.

Changes

send-a-payment.mdx

  • Remove the top-of-page :::warning callout.
  • Display the payment receipt: explain that a successful tx can still be held, and extend the snippet to decode the Transfer log and render "Delivered" vs "Held by receiver policy".
  • Index payment events: add TransferBlocked and note that a Transfer to ReceivePolicyGuard means held, not delivered.
  • Best practices: new "Confirm delivery, not just transaction success" section using the Failed / Delivered / Held framing from the T6 integrator notes.
  • Learning resources: add a card linking to Configure Receive Policies (the callout was the only link to it on this page).

accept-a-payment.mdx (receiver-side counterpart, previously silent on receive policies)

  • Receive stablecoin payments: one paragraph on opting into a receive policy and what happens to blocked payments.
  • Listen for TIP-20 transfer events: filter the viem watcher by to, and explain Transfer-to-guard + TransferBlocked as the held signal.
  • Payment Verification Best Practices: add item 5, check the recipient rather than tx success.

Review notes

  • The new receipt-decoding snippet uses parseEventLogs from viem and the existing Abis.tip20 export already imported by the batch recipe. It has not been run through the twoslash build locally; please confirm it type-checks in the docs preview.
  • The #understand-receive-policy-behavior anchor targets the existing "Understand receive policy behavior" heading on Configure Receive Policies.

🤖 Generated with Claude Code

…line

T6 has been live on testnet and mainnet since June 2026, so the
"On post-T6 networks" warning at the top of Send a Payment no longer
reflects reality. Remove the callout and fold its guidance into the
places where readers act on it:

- Send a Payment: receipt step decodes the Transfer log and shows
  Delivered vs Held; Index payment events covers TransferBlocked;
  new best-practice section with Failed / Delivered / Held outcomes;
  learning-resources card for Configure Receive Policies.
- Accept a Payment: explain receive policies and ReceivePolicyGuard up
  front, filter the Transfer watcher by `to`, and add a verification
  best practice about checking the recipient rather than tx success.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@vercel

vercel Bot commented Sep 8, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
tempo-docs Ready Ready Preview Sep 8, 2026 2:52pm UTC

Request Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant