POST/solana/payment-intent
Bearer authsolanaPaymentIntentWhen paying for a subscription with Solana, we track the order through this intent. A legacy guest network (no sign-in method) is refused with error.code guest_ (PurchaseError). Every other refusal carries its own code too: offer_, plan_ or start_failed.
Request bodyshow schema
A unique reference string to identify the payment intent added to the Solana transaction
The plan. The PRICE is quoted by the server from the caller's regional tier. yearly_ is the welcome offer (the tier's yearly price less 25%, crediting a year plus the 14-day trial) and is refused unless the caller's offer is redeemable.
ISO 3166-1 storefront country, when the app knows it (Solana keeps the estimate otherwise)
Responses2 statuses · show schema
- the amount the server quoted; the client must pay exactly this. It is the plan price plus a unique sub-cent suffix (0.000001 to 0.009999, in USDC's 6 decimals) that identifies a payment sent without the reference, so show and pay every decimal
the plan's regular price (the full-year price for yearly_onboarding)
the merchant address (base58) to pay; build the payment url from this, never a hardcoded address
the SPL token mint (base58) to pay in (USDC)
A stable code for the refusal, so a client can pick a localized message or flow. One of: guest_: the network is a legacy guest network with no sign-in method, so nothing could sign back in to a plan bought on it. Add a sign-in method (POST /auth/add-auth) first; the apps open their add-sign-in sheet. Store-verified purchases and webhooks are never refused this way. already_: the network already has an active Pro subscription; nothing was charged. plan_: the plan cannot be sold now (no price or product is configured for it). item_: the data pack cannot be sold now. offer_: the welcome offer is not, or no longer, redeemable by this network. checkout_: this deployment has no checkout configured. invalid_: the request names an item, plan, provider, ui mode or reference the endpoint does not take (a client defect). invalid_: the email address the code goes to does not look like one. network_: a data purchase for a network by name came without the name. network_: no network has the given name. rate_limited: too many attempts from this address; try again in a minute. start_failed: the payment could not be started (Stripe or the database failed); a retry may work. asset_: the coin is switched off or not configured, or cannot be quoted right now (rates missing, stale or too far apart, the node or the scanner behind, no free receive address, too many open invoices), or does not deliver balance codes. The UI says it is temporarily unavailable. quote_: the quote's time ran out with nothing received; /pay/crypto/requote gives a new one. underpaid: the invoice ended short, and an operator reviews it. gift_: gift codes are not on sale now (/pay/gift/config enabled is false). invalid_: the number of gifts is not between 1 and the most one order takes (/pay/gift/config max_quantity). invalid_: delivery them needs exactly one recipient address per gift, each an email address. invalid_: send_on is not a date from tomorrow to a year out in the buyer's timezone, or comes without a known one. message_: the gift's note is over 240 characters or its signature over 40. gift_: the gift's note or signature holds a link: a URL scheme (https://, any scheme://), mailto:, www., or a domain with a listed TLD (example.com, bit.ly, t.me/x). The exact rule is the server's model. (GIFTOFPRIVACY.md §10.2), which the site mirrors. gift_: with this order's recipients, the buyer's email (case-insensitive) would pass 20 friend emails in 24 hours: the recipients of its delivery them orders of the last 24 hours that are pending or paid. Delivery me has no daily limit beyond max_quantity cards per order. A pending order whose Gamma purchase was voided is not counted. payment_: an earlier gift's Gamma payment is still being processed (sent to the chain, or landed and being credited), so a new gift purchase with Gamma (/pay/gift/gamma-intent), or the cancel of that purchase (/pay/gift/gamma-cancel), must wait; try again in a few minutes. incorrect_: a Stripe trial's card failed its CVC check when it was attached, so the trial did not start, no Pro was credited, and the card is never charged. Only the purchase report (/subscription/verify-stripe-checkout) answers it, with status invalid. The buyer checks the card details and tries again with a new payment sheet or checkout session. Absent from older servers; clients fall back to message for an absent or unknown code.