[stellar-triage-bot]

🤖 Automated message from the Stellar Triage Bot.

Closes #2963

Working this because @oceans404 added bot:take. The JS payment example said DUPLICATE and TRY_AGAIN_LATER needed handling, then threw on both. This PR handles them in the code.

What changes

In the JavaScript tab of send-and-receive-payments.mdx:

• TRY_AGAIN_LATER: wait 2 s and send the same signed transaction again, until maxTime passes.
• DUPLICATE: treated like PENDING. The example waits for the result.
• ERROR: still throws.
• Polling: pollTransaction() (default 30 attempts, 1 s apart, then the last NOT_FOUND) is replaced by a getTransaction loop. It stops at SUCCESS or FAILED, or when a ledger closes after maxTime. I included this because the old code reported a slow ledger as a failed payment after about 30 s, while the transaction stays valid for 180 s. That is the double-pay risk the issue names.

Sources

• @stellar/stellar-sdk v17.4.0: SendTransactionStatus (rpc/api.ts:515), pollTransaction (rpc/server.ts:1240-1260, default DEFAULT_GET_TRANSACTION_TIMEOUT = 30 at :114, BasicSleepStrategy 1000 ms at :231).
• stellar-core TransactionQueue.cpp: meanings of DUPLICATE and TRY_AGAIN_LATER.
• stellar-core TransactionFrame::isTooLate: a transaction is too late when maxTime is earlier than the ledger close time.
• Live testnet getTransaction: latestLedgerCloseTime is a string, so the code wraps it in Number().

Checks

• pnpm is not available in this environment, so pnpm format:mdx, pnpm check and pnpm check:links did not run here. The CI checks job passed.
• I did not run the example against testnet. I checked it against the SDK and stellar-core source.

Not changed (follow-ups)

• The Java and Go tabs have the same pattern: Java throws on anything but PENDING, and Go gives up after 5 polls.
• Line 41 says RPC "will simply return the saved result" for an applied transaction. stellar-core returns ERROR (txBAD_SEQ) instead.
• Submit and wait (JS): handle TRY_AGAIN_LATER and DUPLICATE, and don't treat a short poll as failure #2962 / Handle every send status in submitTx and poll until the time bound #2977 fix the same logic in the shared submitTx helper.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
stellar-docs	🟢 Ready	View Preview	Nov 1, 2026, 10:27 PM

[stellar-triage-bot]

🤖 Automated message from the Stellar Triage Bot.

Reviewing because this is my own PR for #2963, which @oceans404 called me in on.

Verified: the statuses, response fields and maxTime stop rule match SDK v17.4.0 and stellar-core. The preview renders the new code and all checks pass. Ready to merge.