diff --git a/.gitbook.yaml b/.gitbook.yaml index 24d6e16..d6655e8 100644 --- a/.gitbook.yaml +++ b/.gitbook.yaml @@ -23,7 +23,7 @@ redirects: reward-docs: products/intent-based-bridge/README.md docs: contact/contact-us/README.md rozo-intentpay-techdoc: rozo-intentpay-techdoc.md - testnet: testnet/README.md + testnet: contact/contact-us/README.md # group 2: 2026-09 restructure start/litepaper: start/litepaper.md start/litepaper/rozo-intentpay-techdoc: rozo-intentpay-techdoc.md @@ -32,8 +32,8 @@ redirects: products/intent-based-payment-transfer/intent-based-payment: products/intent-based-payment-transfer/intent-based-payment.md products/cctp-bridge: products/cctp-bridge/README.md products/intent-based-earn: products/intent-based-bridge/README.md - tests/testnet: testnet/README.md - integration/testnet: testnet/README.md + tests/testnet: contact/contact-us/README.md + integration/testnet: contact/contact-us/README.md products/pos-merchant-app: products/mobile-app/pos-merchant-app.md contact/contracts-and-audits: contact/contracts-and-audits.md contact/media-kit: contact/media-kit/README.md @@ -49,3 +49,4 @@ redirects: start/intent-based-earn/rss.xml: products/intent-based-bridge/README.md start/supported-tokens-and-chains/rss.xml: integration/api-doc/supported-tokens-and-chains.md blog/en/faq: contact/faqs.md + integration/api-doc/bridge-api/testnet: contact/contact-us/README.md diff --git a/SUMMARY.md b/SUMMARY.md index 99ecfb0..45e1e56 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -38,7 +38,6 @@ * [Open a Stellar Wallet](integration/api-doc/funding/stellar-wallet-onboarding.md) * [Buy Gas Tokens](integration/api-doc/funding/buy-gas-tokens.md) * [Gas + Stablecoin Funding](integration/api-doc/funding/gas-plus-stablecoin.md) - * [Testnet: Base Sepolia → Stellar](testnet/README.md) * [Merchant API](integration/api-doc/merchant-api.md) * [API Quick Start (Merchant)](integration/api-doc/api-quick-start-merchant.md) * [Merchant API Keys](integration/api-doc/merchant-api-keys.md) diff --git a/contact/contact-us/README.md b/contact/contact-us/README.md index f1e745e..5f67186 100644 --- a/contact/contact-us/README.md +++ b/contact/contact-us/README.md @@ -1,4 +1,8 @@ --- + +## Testnet availability + +The Base Sepolia to Stellar testnet route is currently unavailable. Do not create or fund orders using the previous testnet guide. Contact us below to discuss integration testing. icon: messages --- diff --git a/integration/api-doc/api-quick-start.md b/integration/api-doc/api-quick-start.md index 8a52e43..3bc710e 100644 --- a/integration/api-doc/api-quick-start.md +++ b/integration/api-doc/api-quick-start.md @@ -69,7 +69,7 @@ Preserve the order reference if the result is unclear. Resume status checks inst - [Fee previews and errors](api-for-advanced-used/get-fees.md): handle rejected quotes and read fees from the response. - [Supported chains and tokens](supported-tokens-and-chains.md): discover available routes; individual apps can have narrower support. - [Wallet top-up](api-for-advanced-used/wallet-topup.md): variable-amount deposits. -- [Testnet](../../testnet/README.md): the separate Base Sepolia to Stellar test flow. +- The Base Sepolia to Stellar testnet route is currently unavailable. ## Routing provider (optional) diff --git a/rozo-intentpay-techdoc.md b/rozo-intentpay-techdoc.md index f61e6eb..602c300 100644 --- a/rozo-intentpay-techdoc.md +++ b/rozo-intentpay-techdoc.md @@ -59,6 +59,6 @@ For intent payment notifications, follow [Webhook](integration/api-doc/api-for-a ## Test and review -Start with the [Base Sepolia to Stellar testnet guide](testnet/README.md) when it covers your intended route. Check success, expiry, duplicate requests and interrupted status polling before accepting customer payments. Features outside that test route have their own environment and access requirements. +The Base Sepolia to Stellar testnet route is currently unavailable. Contact Rozo to discuss integration testing before accepting customer payments. For public contract source and published reviews, see [Contracts & Audits](contact/contracts-and-audits.md). For integration questions or an unresolved payment, [contact Rozo](contact/contact-us/README.md) with the relevant order reference and transaction evidence. diff --git a/start/capabilities.md b/start/capabilities.md index 8cf448d..0342ea2 100644 --- a/start/capabilities.md +++ b/start/capabilities.md @@ -45,6 +45,6 @@ This catalog links to the documentation for each capability. It is a discovery m - [Fee preview](../integration/api-doc/api-for-advanced-used/get-fees.md): preview an intent payment; Funding uses its own quote flow. - [Webhooks](../integration/api-doc/api-for-advanced-used/webhook.md): intent payment notifications. Funding currently requires polling. - [Look up by transaction hash](../integration/api-doc/api-for-advanced-used/lookup-by-tx-hash.md): locate a payment using its transaction. -- [Testnet](../testnet/README.md): the documented Base Sepolia to Stellar test flow, not a test environment for every product. +- The Base Sepolia to Stellar testnet route is currently unavailable. For an ordered walkthrough, choose the [Merchant](merchants.md), [Wallet](wallets.md) or [Agent](agents.md) guide. diff --git a/start/wallets.md b/start/wallets.md index 1d666fc..3a1af52 100644 --- a/start/wallets.md +++ b/start/wallets.md @@ -22,7 +22,7 @@ For gas plus a stablecoin, see [Gas + Stablecoin Funding](../integration/api-doc ## Start a cross-chain integration 1. Read [Bridge & Wallet API](../integration/api-doc/bridge-api.md), including app registration and webhook access. Consult [Supported Tokens and Chains](../integration/api-doc/supported-tokens-and-chains.md) and the selected flow's narrower restrictions. -2. Use the [testnet guide](../testnet/README.md) for its documented Base Sepolia to Stellar test route. Testnet coverage does not imply that Funding, MPP or every mainnet route is available there. +2. The Base Sepolia to Stellar testnet route is currently unavailable. Contact Rozo before planning testnet integration. 3. Follow the [Bridge API quick start](../integration/api-doc/api-quick-start.md) and [fee preview](../integration/api-doc/api-for-advanced-used/get-fees.md). Resolve app access before creating a live payment. 4. Have the user approve and pay according to the returned order instructions. Track settlement using that flow's status reference or [webhooks](../integration/api-doc/api-for-advanced-used/webhook.md). diff --git a/testnet/README.md b/testnet/README.md index 1a007c3..7d7c6dd 100644 --- a/testnet/README.md +++ b/testnet/README.md @@ -1,78 +1,5 @@ -# Base Sepolia to Stellar Testnet +# Testnet currently unavailable -Use this guide to try a Base Sepolia USDC payment to a Stellar testnet recipient. It covers classic Stellar accounts (`G` addresses) and compatible Soroban contract accounts (`C` addresses). These are test networks: do not send mainnet funds. +The Base Sepolia to Stellar testnet route is currently unavailable. Do not create or fund test orders using the previous guide. -## Before you start - -- Use a wallet you control on Base Sepolia, with test USDC and test ETH for transaction fees. Test tokens are available from the [Circle USDC faucet](https://faucet.circle.com/) and [Alchemy Base Sepolia faucet](https://www.alchemy.com/faucets/base-sepolia). -- Choose your own Stellar **testnet** recipient. Confirm that it can receive the test USDC asset. A `C` address must identify the intended compatible contract on testnet. -- The documented source amount range is 0.01 to 1.00 test USDC. The order response supplies the actual payment instructions and expiry. -- This endpoint does not require an authentication header. Its test app ID is not a production app registration. - -API base URL: - -```text -https://intentapitestnet.rozo.ai/functions/v1/payment-api -``` - -## 1. Create a test order - -Replace `YOUR_STELLAR_TESTNET_RECEIVER` with your recipient and choose a unique `orderId` for this test. The placeholder is deliberately not a payable address. - -```bash -curl -sS -X POST 'https://intentapitestnet.rozo.ai/functions/v1/payment-api/payments' \ - -H 'Content-Type: application/json' \ - -d '{ - "appId": "testnet-base-to-stellar", - "orderId": "YOUR_UNIQUE_TEST_ORDER_ID", - "type": "exactIn", - "source": { - "chainId": "84532", - "tokenSymbol": "USDC", - "amount": "0.01" - }, - "destination": { - "chainId": "1500", - "receiverAddress": "YOUR_STELLAR_TESTNET_RECEIVER", - "tokenSymbol": "USDC" - } - }' -``` - -Save the returned payment `id`. Read `source.receiverAddress`, `source.amount` and `expiresAt` from that response. The required source amount can differ from the amount requested; follow the returned instructions instead of calculating a deposit amount yourself. - -## 2. Pay with your test wallet - -In your Base Sepolia wallet, send the returned amount of test USDC to the returned source address before the order expires. Check the network and asset before approving the transfer. - -Use your wallet's normal signing flow. No private key needs to be pasted into these API requests or shared with Rozo. Do not reuse a deposit address copied from an old order or documentation example. - -## 3. Read the result - -Replace `YOUR_PAYMENT_ID` with the ID from step 1: - -```bash -curl -sS 'https://intentapitestnet.rozo.ai/functions/v1/payment-api/payments/YOUR_PAYMENT_ID' -``` - -| Testnet `status` | What to do | -| --- | --- | -| `payment_unpaid` | Waiting for the source payment | -| `payment_payin_completed` | Source payment confirmed; keep checking the destination result | -| `payment_completed` | Check the destination amount and transaction against your test order | -| `payment_expired` | If unpaid, create a new order; if you already paid, contact support before sending again | -| `payment_bounced` | Stop and contact support with the payment ID and error details | - -A created order or source transaction is not proof of destination delivery. Confirm the resulting transaction on Stellar testnet and the amount credited to your chosen recipient. If an error or interruption leaves the outcome unclear, resume checking the existing order rather than paying again. - -## G and C recipient differences - -- A classic `G` account receives a Stellar payment operation; its account and asset trustline must be ready to receive the asset. -- A compatible `C` account receives through the Stellar Asset Contract token transfer. Do not use this path for an exchange deposit that requires a classic payment memo. -- If your integration decodes Soroban transaction results itself, use an SDK that supports the transaction metadata returned by the network. A server-side payout error requires Rozo support; your application does not deploy the payout service. - -The request selects the recipient through `destination.receiverAddress`. Do not infer support for a particular passkey wallet or contract solely from the address prefix. - -## Next steps - -See the [Wallet guide](../start/wallets.md) for production integrations and access requirements. Testnet coverage here does not imply testnet support for every Funding, Checkout or MPP feature. For a failed or unclear test, [contact Rozo](../contact/contact-us/README.md) with the payment ID and relevant transaction hashes; never include a private key. +For integration testing, [contact Rozo](../contact/contact-us/README.md).