--- name: v402pay.onvoyage.ai description: v402pay.onvoyage.ai is a Solana-based micropayment gateway that processes 0.01 USDC payments to unlock gated content on the Voyage platform. Each skill submits a Solana USDC transaction and returns a short-lived JWT access token (valid ~60 seconds) that grants one-time read access to a specific paywalled article or API resource. host: v402pay.onvoyage.ai --- # v402pay.onvoyage.ai This host serves agents that need to programmatically pay for and access paywalled content on the Voyage platform using Solana USDC micropayments. It provides both generic article-unlock endpoints (parameterized by articleId) and article-specific endpoints pre-configured for named pieces such as 'Crypto Market Trends', 'Decoding Whale Movements', and the Great Search API. All payment settlement is on Solana; EVM chains are not supported for settlement. ## When to use this host Use this host when an agent needs to pay for and immediately access paywalled article content or the Great Search API on the Voyage platform using Solana USDC micropayments. All skills settle exclusively on Solana — do not use this host for EVM-native payment flows, other chains, or non-USDC tokens. This host is not suitable for recurring subscriptions, bulk content purchases, or variable-amount payments; it is strictly an exact 0.01 USDC one-time-access scheme. Access tokens expire in ~60 seconds, so the agent must consume the unlocked content immediately after payment. For EVM-based micropayment flows or other content platforms, a different payment host should be used. ## Capabilities ### Generic Article Micropayment Unlock Parameterized endpoints that accept an articleId and Solana USDC payment details to unlock any supported paywalled article, returning a short-lived JWT access token. - **`unlock-gated-article-content`** — Processes a 0.01 USDC Solana micro-payment and returns a short-lived JWT access token to unlock gated article content. - **`unlock-article-with-solana-micropayment`** — Submits a 0.01 USDC payment on Solana to unlock a paywalled article and returns a short-lived JWT access token valid for 60 seconds. ### Named Article Unlock Pre-configured endpoints targeting specific named articles on the Voyage platform, requiring minimal input since the article identifier is fixed. - **`unlock-whale-movements-article`** — Processes a 0.01 USDC Solana micro-payment and returns a one-time JWT access token for the 'Decoding Whale Movements' article (article ID 18). ### API Access Payment Submits an exact 0.01 USDC Solana payment to unlock access to the Great Search API, returning a transaction hash and payment confirmation. - **`post-greatsearch-solana-payment`** — Submits a Solana USDC exact-payment to unlock the Great Search API, returning a transaction hash and payment confirmation within a 60-second timeout. ## Workflows ### Pay and Read Named Article *Use when an agent needs to access the 'Decoding Whale Movements' article: first pay to obtain the access token, then use the token in a follow-up GET request to fetch the article body.* 1. **`unlock-whale-movements-article`** — Submit the 0.01 USDC Solana micropayment for article ID 18 and receive a one-time JWT access token. 2. **`unlock-gated-article-content`** — If the named endpoint is unavailable, fall back to the generic unlock endpoint with articleId set to 18 to obtain an equivalent access token for the same content. ### Generic Article Access Flow *Use when an agent needs to unlock any paywalled Voyage article by articleId and the specific article does not have a dedicated named endpoint.* 1. **`unlock-gated-article-content`** — Submit payment with the target articleId and Solana wallet details to receive a short-lived JWT access token. 2. **`unlock-article-with-solana-micropayment`** — Alternative generic endpoint: use if the first skill's parameter schema better matches the available wallet context (e.g., feePayerSolanaWallet is known). ## Skill reference ### `unlock-gated-article-content` **Solana MicroPay Article Unlock** — Processes a 0.01 USDC Solana micro-payment and returns a short-lived JWT access token to unlock gated article content. *Use when:* Use when an agent or user needs to pay for and immediately access a paywalled article identified by an itemId, receiving a one-time access token valid for 60 seconds after payment confirmation. *Not for:* Do not use for recurring subscriptions, bulk content purchases, or non-article gated resources. Not suitable for EVM-native payment flows — this endpoint settles on Solana. **Inputs:** - `chain` (string, required) — Blockchain network for the payment. Must be 'solana'. - `amount` (number, required) — Payment amount in the smallest unit of the specified currency (e.g., 100 = 0.01 USDC with 4 decimals). - `itemId` (string, required) — Identifier of the gated article or content item to unlock. - `currency` (string, required) — Currency token symbol for the payment. Must be 'USDC'. - `returnUrl` (string) — URL to redirect or callback after payment is processed. - `tokenAddress` (string, required) — Solana SPL token mint address for the payment token. - `payerEvmWallet` (string) — EVM wallet address of the payer, used for cross-chain identity linkage. - `recipientSolanaWallet` (string, required) — Solana wallet address of the content provider receiving the payment. - `payerBaseUsdcTokenAddress` (string) — Base chain USDC token contract address for the payer, used for cross-chain reference. **Returns:** Returns code 0, Solana transaction hash, payer/recipient addresses, settled amount (0.01 USDC), and a 60-second JWT accessToken for one-time article content access. **Example:** `{"chain":"solana","amount":100,"itemId":"gated-article-1001","currency":"USDC","returnUrl":"https://example.com/content/unlock?item=gated-article-1001","tokenAddress":"EfPoo4wWgxKVToit7yX5VtXXBrhao4G8L7vrbKy6pump","payerEvmWallet":"0x402Feee072D655B85e08f1751AF9ddbCd249521f","recipientSolanaWallet":"X4o2D8op42a2jcNJJVZcDq3eYivh1oR9XiezPWCXosZ","payerBaseUsdcTokenAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}` --- ### `unlock-article-with-solana-micropayment` **Solana MicroPay Article Unlock** — Submits a 0.01 USDC Solana micropayment and returns a one-time JWT access token to unlock the gated article 'Crypto Market Trends'. *Use when:* Use when an agent needs to pay for and retrieve a one-time access token to read the gated 'Crypto Market Trends' article via a Solana USDC micropayment of approximately $0.01. *Not for:* Do not use for recurring subscriptions, EVM-native payments, or unlocking articles other than 'Crypto Market Trends'; use a different endpoint or payment flow for those cases. **Inputs:** - `payment.amount` (number, required) — Payment amount in the smallest unit (e.g., 100 = 0.01 USDC with 4 decimals). - `payment.network` (string, required) — Blockchain network for the payment. Must be 'solana'. - `payment.currency` (string, required) — Currency of the payment. Must be 'USDC'. - `payment.tokenMint` (string, required) — Solana mint address of the USDC token being used for payment. - `payment.callbackUrl` (string, required) — URL to receive the payment callback with access token and article unlock details. - `payment.payerSolanaAddress` (string, required) — Solana wallet address of the payer initiating the micropayment. - `payment.baseRedirectEvmAddress` (string) — Optional EVM address used for redirect or cross-chain reference purposes. - `articleId` (string, required) — Identifier of the article to unlock. Use 'crypto-market-trends' for the supported article. **Returns:** Returns code=0 with paymentInfo (transaction hash, payer/recipient addresses, 0.01 USDC amount, timestamp) and a one-time JWT accessToken expiring in 60 seconds for the unlocked article. **Example:** `{"payment":{"amount":100,"network":"solana","currency":"USDC","tokenMint":"EfPoo4wWgxKVToit7yX5VtXXBrhao4G8L7vrbKy6pump","callbackUrl":"https://example.com/payments/solana/micropay/callback","payerSolanaAddress":"X4o2D8op42a2jcNJJVZcDq3eYivh1oR9XiezPWCXosZ","baseRedirectEvmAddress":"0x402Feee072D655B85e08f1751AF9ddbCd249521f"},"articleId":"crypto-market-trends"}` --- ### `post-greatsearch-solana-payment` **GreatSearch Pay (Solana USDC)** — Submits a Solana USDC exact-payment to unlock the Great Search API, returning a transaction hash and payment confirmation within a 60-second timeout. *Use when:* Use when an agent needs to pay 0.01 USDC on Solana to unlock access to the Great Search API, providing recipient wallet, optional fee payer, and an optional callback URL for webhook notification. *Not for:* Do not use for non-Solana networks or non-USDC tokens; use a different payment endpoint for other chains or currencies. Not suitable for approximate or variable-amount payments — this is an exact-payment scheme only. **Inputs:** - `exact` (boolean, required) — Must be true to indicate an exact-payment scheme. - `token` (string, required) — Solana mint address of the token being used for payment (USDC). - `amount` (number, required) — Payment amount in atomic units (e.g., 250 for 0.01 USDC with 4 decimals... use the token's decimal precision). - `network` (string, required) — Blockchain network for the payment. Must be 'solana'. - `currency` (string, required) — Currency symbol for the payment. Must be 'USDC'. - `recipientWallet` (string, required) — Solana wallet address of the payment recipient. - `callbackUrl` (string) — URL to receive a webhook notification after payment is processed. - `referenceId` (string) — Caller-supplied idempotency or reference identifier for this payment. - `feePayerWallet` (string) — Solana wallet address that pays the transaction fee, if different from the payer. - `timeoutSeconds` (integer) — Maximum seconds to wait for payment confirmation. Defaults to 60. **Returns:** Returns code=0, a transactionHash on Solana, payer/recipient addresses, amount '0.01' USDC, a traceId, and a callbackContent object indicating whether the webhook notification succeeded. **Example:** `{"exact":true,"token":"EfPoo4wWgxKVToit7yX5VtXXBrhao4G8L7vrbKy6pump","amount":250,"network":"solana","currency":"USDC","callbackUrl":"https://example.com/payments/great-search/solana/callback","referenceId":"gs-sol-usdc-9f2c7a3b-2c4e-4f2f-8bd9-7dd5b2d2a2a1","feePayerWallet":"X4o2D8op42a2jcNJJVZcDq3eYivh1oR9XiezPWCXosZ","timeoutSeconds":60,"recipientWallet":"X4o2D8op42a2jcNJJVZcDq3eYivh1oR9XiezPWCXosZ"}` --- ### `unlock-article-with-solana-micropayment` **Solana USDC Article Micropayment Unlock** — Submits a 0.01 USDC payment on Solana to unlock a paywalled article and returns a short-lived JWT access token valid for 60 seconds. *Use when:* Use when an agent needs to pay for and gain time-limited access to a paywalled article by sending a Solana USDC micro-payment, receiving a one-time JWT access token in return. *Not for:* Do not use for recurring subscriptions, payments above micro-payment amounts, or non-article content unlocks. Not suitable for EVM-native payment flows — this endpoint settles on Solana. **Inputs:** - `chain` (string, required) — Blockchain network for the payment. Must be 'solana'. - `amount` (number, required) — Payment amount in the smallest unit of the currency (e.g., 100 = 0.01 USDC with 4 decimal places). - `currency` (string, required) — Currency for the payment. Must be 'USDC'. - `articleId` (string, required) — Identifier of the article to unlock access to. - `recipientSolanaWallet` (string, required) — Solana wallet address of the payment recipient. - `tokenMint` (string) — Solana mint address of the token being used for payment. - `feePayerSolanaWallet` (string) — Solana wallet address that will pay transaction fees on behalf of the payer. - `evmWallet` (string) — EVM wallet address associated with the payer, if applicable. - `baseUsdcTokenAddress` (string) — EVM contract address for the base USDC token, if applicable. - `timeoutSeconds` (integer) — Number of seconds before the payment request times out. Defaults to 60. **Returns:** Returns code=0 with paymentInfo (transaction hash, payer/recipient addresses, amount, timestamp) and a 60-second JWT accessToken for one-time article access. **Example:** `{"chain":"solana","amount":100,"currency":"USDC","articleId":"sol-unlock-9f2c3a1b","recipientSolanaWallet":"X4o2D8op42a2jcNJJVZcDq3eYivh1oR9XiezPWCXosZ","tokenMint":"EfPoo4wWgxKVToit7yX5VtXXBrhao4G8L7vrbKy6pump","feePayerSolanaWallet":"X4o2D8op42a2jcNJJVZcDq3eYivh1oR9XiezPWCXosZ","timeoutSeconds":60}` --- ### `unlock-whale-movements-article` **Whale Movements Article Unlock** — Processes a 0.01 USDC Solana micro-payment and returns a one-time JWT access token for the 'Decoding Whale Movements' article (article ID 18). *Use when:* Use when an agent or user needs to pay for and gain temporary read access to the 'Decoding Whale Movements' article on the Voyage platform, receiving a short-lived access token to fetch the article content. *Not for:* Do not use for recurring or subscription-based article access; the token is one-time use and expires in 60 seconds. Not suitable for fetching the article content itself — use the returned accessToken in a separate GET request for that. **Inputs:** - `amount` (number, required) — Payment amount in USDC cents or atomic units as used by the x402 paywall. The verified test value is 100. **Returns:** Returns code 0 with payment details (transaction hash, payer/recipient addresses, amount) and a one-time JWT accessToken for article ID 18 that expires in 60 seconds. **Example:** `{"amount": 100}` ---