Skip to content
SineraDocs

Offers and embed codes

Fix your terms once, sign an offer with your wallet and put a pay button on your own website.

Domain in the Developer Portal lets you fix the terms of what you sell once, sign them with your wallet, and put a card with a pay button on your own website. A visitor who pays for an item creates and escrows an Atom with exactly those terms. It works the same whether you signed in with a wallet or a Sinera account, although activating an offer needs a wallet signer.

Implementation candidate

The idea in four lines

  1. Pick a template. These are the Sinera App's own templates, such as an online order or a freelance project.
  2. Fill in your offer: a price for each item, the time windows and the rules.
  3. Activate it. Your wallet signs the offer. This is a signature, not a transaction, and costs nothing.
  4. Copy the embed code and paste it into your site.

The three tabs

TabWhat it shows
TemplatesEvery template, with its domain. Readable without signing in.
DraftsOffers you started and have not signed. Continue or delete them.
ActiveOffers you signed. Copy the embed code, open the checkout, or remove the offer from the list.

Your offers are kept in this browser only. They do not sync to other browsers or devices, and clearing site data removes the list. An active offer's link keeps working even if the list is lost, so keep a copy of the embed code.

Templates

A template has commits and items. An item is one thing you deliver for one price. Each item is one payment and becomes one Atom, and a buyer pays the items one at a time.

The ten templates are: Blank (you add up to twelve items yourself), Online order, Purchase order in lots, Service engagement, Freelance project, Escrowed exchange, Monthly subscription, Metered API access, Compute rental, and Sample Test.

Each template is filed under one of twelve domains, such as product and procurement, API, subscription and SaaS, or lease and rental. Filter by domain to read how it is cut into payments and what an offer in it does not establish, for example legal title, regulatory compliance or liability. Several domains have no template yet.

Set up an offer

1. Template. Read the commits and items: what each delivers, its unit, whether the quantity is yours to set, and the planned days.

2. Offer. Add a title and description for the buyer, the price token, and one row per item.

FieldMeaning
IncludeLeave out items you do not offer. At least one stays.
What the payment is forA reference of your own, such as an order number. Each item needs its own.
Quantity and unitDescribes what is delivered. The Atom itself escrows money only.
Total priceWhat the buyer escrows for this item. For a metered item, enter the amount due once usage is known.
Delivery timeStarts from the template's planned days. Change it to your terms.

Prices are in a stablecoin the network admits (USDT or USDC).

3. Rules. These apply to every item in the offer.

FieldMeaning
Time to accept an orderHow long you have to accept an Atom after the buyer escrows. If you do not, it expires and the buyer is refunded.
Time to accept a revisionHow long the buyer has to accept a revision you propose.
Challenge windowHow long the buyer has after delivery to raise a problem before payment is released.
CompletionWho may confirm completion early.
DisputesWhether a dispute can be opened on these Atoms.
Valid untilWhen the offer stops working. At most 90 days from now.

Time windows start from the template's suggested values and cannot go below its floor. The floors protect the buyer. Where a template suggests no value, enter the one your own terms state.

4. Review. Everything in plain words, item by item, with the total.

5. Activate. Check the exact data your wallet will sign, then choose Sign and activate. Nothing is sent to the network. If you decline, the draft stays as it was.

6. Done. You get the embed code and the checkout link. You can leave at any step from Offer onwards because the draft saves as you go.

Before you sign

  • The item order is your plan, not a chain rule. A buyer could pay a later item first. You decline an out-of-order Atom by not accepting it.
  • A signed offer cannot be withdrawn. Every copy of its link works until the offer expires. Choose the end date with that in mind.
  • You accept each Atom on-chain. If you do not accept within your window, the Atom expires and the buyer is refunded.
  • The card and its link are public. Anyone with them sees the title, description, price, your wallet address and the rules.
  • Removing an offer from Active does not withdraw it. It only removes it from this browser.

Embed code

From Active or the last step, open Embed code. You get an <iframe> snippet that shows the card, and a plain checkout link for sites that block iframes. The card shows the title, each item with price and button, your address, the main rules and whether the signature was verified. Frame height depends on the number of items. If an offer has expired, was altered or cannot be verified, the card says it is unavailable and shows no pay button.

What the buyer does

The button opens checkout for that item in a new tab. The buyer signs in with a wallet, sees the item and your fixed terms and that your signature was verified, approves the token if needed, and sends the transaction after a successful simulation. This is the create an Atom flow with terms fixed by your offer. A buyer cannot use an offer from the seller's own address.

Where the portal operator has turned sending off, the button reads Review and simulate. The buyer can review, simulate and export the transaction but not send it from the portal.

When you cannot activate

  • Signed in with a Sinera account: the draft is saved. Sign in with a wallet to activate it.
  • Network not deployed: templates can be read, but an offer needs a deployed network.
  • Wrong wallet network: switch your wallet to the network in the header.