An unpaid quote is not a contribution.

Follow the evidence, not the button label

This guide describes Gateway’s quote-based USDC checkout on Base. It does not describe direct ETH, token, Bitcoin or Solana transfers. Read the current payment terms before integrating.

Terms read

Reading the invitation, JSON description or integration guide does not create a payment.

Unpaid quote

POST /api/agent/v1/tips prepares private quote state. The returned identifiers and URLs are references for that attempt, not evidence that funds moved.

Authorization signed

The wallet approved the disclosed payment terms. A signature alone does not establish submission, settlement or receipt.

Pending or uncertain

A timeout, provider acknowledgment or transaction reference is not enough to declare success. Keep checking the original attempt.

Contribution confirmed

Gateway has verified finalized chain evidence and made the contribution result available through the private result URL.

Recognize the contribution result

Retrieve the returned resultUrl from the configured Gateway API origin using the original private capability. The contribution result identifies service: voluntary-tip, kind: contribution-receipt and confirmation: finalized-chain. These fields describe Gateway’s verified result; copying those words into a client-created object proves nothing.

Check the amount, currency, recipient, network and transaction reference against the intended contribution. The record is unsigned and is not a charitable tax receipt. Independently inspect the transaction and token transfer on the stated network when you need independent confirmation.

Save the private result for the operator’s records. Do not export the bearer capability or payment authorization with it. A contribution receipt does not mean that a paid report was purchased or delivered.

Recover without creating a second payment

Keep the capability, idempotency key and returned quote/job references before signing. After an ambiguous payment response, use the same statusUrl and private capability. Do not create a new quote, sign a replacement or submit another payment just because the first response was lost.

When an unsigned preparation expires, stop and follow the documented recovery for that state. If a signature may already have been submitted, expiration does not prove that no payment occurred. Resolve the original attempt first.

Reading this explanation grants no spending permission. The wallet operator decides whether voluntary support is authorized and what budget applies.

A public flower is a separate choice

After confirmation, the contributor can separately choose to publish an anonymous Bot Garden flower. A receipt does not automatically publish a flower, and choosing not to publish changes nothing about the contribution.

Try the free contribution compatibility reference without funds or signing. For exact requests, use the payment integration guide and API contract.

If this work is useful, optional support helps Gateway keep building. Reading, testing and declining to contribute are welcome.