Skip to content

Add Pay.sh pages for Accept Payments and Subscriptions#1525

Merged
lgalabru merged 9 commits into
solana-foundation:mainfrom
datasalaryman:payments-with-paysh
Jul 9, 2026
Merged

Add Pay.sh pages for Accept Payments and Subscriptions#1525
lgalabru merged 9 commits into
solana-foundation:mainfrom
datasalaryman:payments-with-paysh

Conversation

@datasalaryman

Copy link
Copy Markdown
Contributor

No description provided.

@vercel

vercel Bot commented Jun 9, 2026

Copy link
Copy Markdown

@datasalaryman is attempting to deploy a commit to the Solana Foundation Team on Vercel.

A member of the Team first needs to authorize it.

@greptile-apps

greptile-apps Bot commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

This PR adds two new documentation pages (pay-sh.mdx) under the Accept Payments and Subscriptions sections, and expands the existing Agentic Payments page with inline Pay.sh installation steps. The changes document how to use the pay.sh CLI to accept per-request payments and recurring subscriptions on HTTP APIs.

  • Two new MDX pages covering Pay.sh setup, demo server configuration, YAML endpoint specs, and client-side subscription management commands.
  • agentic-payments.mdx updated to include the same inline install block (brew install pay / npm install -g @solana/pay, pay --version, pay setup) that the two new pages also carry.
  • meta.json files for both sections updated to register pay-sh in the sidebar navigation.

Confidence Score: 5/5

Documentation-only change adding new MDX pages and sidebar entries; no runtime code is touched and no breaking changes are introduced.

All changes are Markdown/MDX content files and JSON sidebar config. The new pages document Pay.sh CLI usage with copy-pasteable shell and YAML snippets, none of which affect the docs site's own runtime behavior.

The two new pay-sh.mdx files warrant a quick editorial pass for the setup-and-topup command mismatch and the hardcoded example secret in the subscriptions YAML.

Important Files Changed

Filename Overview
apps/docs/content/docs/en/payments/accept-payments/pay-sh.mdx New doc page for accepting payments with Pay.sh; prose says "setup and topup your wallet" but only shows pay setup, and a sentence is missing a trailing period.
apps/docs/content/docs/en/payments/subscriptions/pay-sh.mdx New doc page for Pay.sh subscriptions; contains a hardcoded example challenge_binding_secret that readers may copy verbatim, and the same "setup and topup" text/code mismatch.
apps/docs/content/docs/en/payments/agentic-payments.mdx Added inline Pay.sh install steps; same "setup and topup" text/code mismatch as the two new files.
apps/docs/content/docs/en/payments/accept-payments/meta.json Adds pay-sh to the Accept Payments sidebar pages list; straightforward config change.
apps/docs/content/docs/en/payments/subscriptions/meta.json Adds pay-sh to the Subscriptions sidebar pages list; straightforward config change.

Sequence Diagram

%%{init: {'theme': 'neutral'}}%%
sequenceDiagram
    participant Client as Client (pay CLI)
    participant Server as Pay Server
    participant Chain as Solana Chain

    Client->>Server: HTTP GET /api/v1/...
    Server-->>Client: 402 Payment Required (terms)
    Client->>Client: Wallet approves signing
    Client->>Server: Retry with signed payment
    Server->>Chain: Submit / verify transaction
    Chain-->>Server: Settlement confirmed
    Server-->>Client: 200 OK (response data)
Loading
%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
sequenceDiagram
    participant Client as Client (pay CLI)
    participant Server as Pay Server
    participant Chain as Solana Chain

    Client->>Server: HTTP GET /api/v1/...
    Server-->>Client: 402 Payment Required (terms)
    Client->>Client: Wallet approves signing
    Client->>Server: Retry with signed payment
    Server->>Chain: Submit / verify transaction
    Chain-->>Server: Settlement confirmed
    Server-->>Client: 200 OK (response data)
Loading

Reviews (6): Last reviewed commit: "fix: show json response instead" | Re-trigger Greptile

Comment thread apps/docs/content/docs/en/payments/accept-payments/pay-sh.mdx
Comment thread apps/docs/content/docs/en/payments/subscriptions/pay-sh.mdx Outdated
Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>
Comment thread apps/docs/content/docs/en/payments/accept-payments/pay-sh.mdx Outdated
Comment thread apps/docs/content/docs/en/payments/accept-payments/pay-sh.mdx Outdated
Comment thread apps/docs/content/docs/en/payments/accept-payments/pay-sh.mdx
Comment thread apps/docs/content/docs/en/payments/subscriptions/pay-sh.mdx Outdated
@vercel

vercel Bot commented Jun 11, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
solana-com-docs Ready Ready Preview, Comment Jun 11, 2026 8:58pm

Request Review

@datasalaryman datasalaryman requested a review from lgalabru June 12, 2026 06:44
Comment thread apps/docs/content/docs/en/payments/subscriptions/pay-sh.mdx Outdated
Comment thread apps/docs/content/docs/en/payments/subscriptions/pay-sh.mdx Outdated
@datasalaryman datasalaryman requested a review from lgalabru June 23, 2026 00:25

@lgalabru lgalabru left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looking good thanks @datasalaryman!

@datasalaryman

Copy link
Copy Markdown
Contributor Author

gm gm, I can't merge 😅

@lgalabru lgalabru merged commit 618f20c into solana-foundation:main Jul 9, 2026
16 of 22 checks passed
@datasalaryman datasalaryman deleted the payments-with-paysh branch July 12, 2026 02:43
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.

2 participants