> For the complete documentation index, see [llms.txt](https://developers.tezos.domains/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.tezos.domains/interoperability/affiliated-buys-and-renewals.md). # Affiliated Buys & Renewals Tezos Domains introduces an affiliate model that allows partners to offer domain purchases directly through their own apps. Affiliates earn a percentage with each tracked sale. This model is ideal for integration into wallets, marketplaces, and explorers, though any Tezos project can become an affiliate partner. To join the program, please follow the steps on [Tezos Domains Forum](https://talk.tezos.domains/t/registration-verification-for-the-tezos-domains-affiliate-program/317). Affiliate purchases are tracked using a dedicated smart contract. This contract extends the standard [buy and renewal](/interoperability/buys-and-renewals.md) entrypoints by including an additional `affiliate` parameter, which identifies the affiliate partner by their Tezos address. You can find the mainnet address in our [deployed contracts list](/deployed-contracts/mainnet.md). ## Contract: AffiliateBuyRenew ### Entrypoint: buy Buys a second-level domain based on previous commitment (see [TLDRegistrar.Commit](/interoperability/buys-and-renewals.md#contract-tldregistrar-commit)). **Amount restriction**: The amount sent with this call has to be equal to the price of the domain. The price in mutez is calculated as `standard_price_per_day * duration / 1000000`. | Parameter | Type | Description | | ------------- | --------------------- | ------------------------------------------------------------------------- | | **label** | `bytes` | The UTF-8 encoded label of the second-level domain to buy. | | **duration** | `nat` | Ownership duration represented in days. | | **owner** | `address` | The new owner of the given domain. | | **address** | `address option` | The optional address the given domain resolves to. | | **data** | `(string, bytes) map` | A map of any additional data clients wish to store with the given domain. | | **nonce** | `nat` | The chosen commitment nonce. | | **affiliate** | `address` | Address uniquely identifying the affiliate. | **Errors:** | Error | Description | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | COMMITMENT\_DOES\_NOT\_EXIST | Corresponding commitment (see [TLDRegistrar.Commit](/interoperability/buys-and-renewals.md#contract-tldregistrar-commit)) was not created before. | | COMMITMENT\_TOO\_OLD | The commitment is too old (older than configured age). Try recreating it again. | | COMMITMENT\_TOO\_RECENT | The commitment is too recent (younger than configured age). Wait for some time. | | LABEL\_TAKEN | The requested **label** already exists and it is not expired. | | LABEL\_NOT\_AVAILABLE | The requested **label** is currently not available for registration. | | LABEL\_IN\_AUCTION | The requested **label** is currently only available in auction. | | INVALID\_LABEL | The given **label** is not valid. See [Label Validation](/interoperability/domain-operations.md#label-validation). | | LABEL\_EMPTY | The given label is empty. | | LABEL\_TOO\_LONG | The label is too long. | | NAME\_TOO\_LONG | The name (label + parent) is too long. | | DURATION\_TOO\_LOW | The requested **duration** is too low (lower than the configured minimum). | | AMOUNT\_TOO\_LOW | The transferred **amount** is lower than the actual price. | | AMOUNT\_TOO\_HIGH | The transferred **amount** is higher than the actual price. | ### Entrypoint: renew Renews second-level domain for requested duration. **Amount restriction**: The amount sent with this call has to be equal to the price of the domain. The price in mutez is calculated as `standard_price_per_day * duration / 1000000`. | Parameter | Type | Description | | ------------- | --------- | ---------------------------------------------------------- | | **label** | `bytes` | The UTF-8 encoded label of the second-level domain to buy. | | **duration** | `nat` | The renewal duration represented in days. | | **affiliate** | `address` | Address uniquely identifying the affiliate. | **Errors:** | Error | Description | | ------------------ | ------------------------------------------------------------------------------------------ | | LABEL\_NOT\_FOUND | The requested **label** does not exist. | | LABEL\_EXPIRED | The requested **label** exists but it is expired. Therefore it can be bought, not renewed. | | DURATION\_TOO\_LOW | The specified **duration** is too low (lower than the configured minimum). | | AMOUNT\_TOO\_LOW | The transferred **amount** is lower than the actual price. | | AMOUNT\_TOO\_HIGH | The transferred **amount** is higher than the actual price. | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://developers.tezos.domains/interoperability/affiliated-buys-and-renewals.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.