Aftermarket

From TLDinfo
Jump to: navigation, search

Contents

About the RRPproxy Aftermarket

The RRPproxy Aftermarket gives you the possibility to integrate access to Aftermarket Providers to sell and buy domains in the Aftermarket via API. List and check for domains at Aftermarket Providers directly via RRPproxy. In order to use this service, please make sure Aftermarket is activated for your account. Of course you also need an active account at a supported Aftermarket Provider.

For a successful sale a respective provision is deducted from the selling price by the respective Aftermarket Provider. The difference will be transmitted to the respective account at your Aftermarket Provider.

When buying a domain, the price is deducted from your RRPproxy account directly.

You might know that depending on the Aftermarket Provider there are different methods to sell and buy domains in Aftermarkets. As of know we have only implemented the fixed price variant. At a later stage, we will also release support for bidding processes, where potential buyers can place offers for a domain listed for sale. We expect to launch this feature in short time. During reading this documentation you might notice at some points additional options would make sense, and you're right. We simply haven't activated them yet.

In a Nutshell: How it works

  • For buying Domains, just query which Domains are up for sale and buy them directly. Adding an Aftermarket Provider account is not necessary.
  • To sell domains you need to add an active Aftermarket Provider account in your RRPproxy account. You can use multiple Aftermarket Provider accounts.
  • The key to sell is to list Domains at Aftermarket Providers.
  • Let the system automatically sell your Domains listed for direct sale.

What happens with the money?

Probably the most important information for all aftermarkets!

Selling

The set price for a domain is the net price which will be received after a successful sale. As usual the money will be transferred directly to the respective Aftermarket Provider account.
All fees and provisions are added to the set price by the respective Aftermarket Provider.

Buying

When buying a domain the amount is directly deducted from the RRPproxy Reseller account balance. So please make sure it is sufficiently funded to guarantee smooth operation.
In case your RRPproxy Reseller account belongs to a German company, or an EU company without VAT, we have to 19% VAT to the deducted amount.

Supported Aftermarket Providers

Currently only Sedo is supported. But we're already working on integrating further Aftermarket Providers.

Direct Sale

A Direct Sale is listing a domain for a fixed price. The price can be accepted directly by interested parties and the sale will be performed in real-time.

Hints for implementation

  • The RRPproxy Aftermarket System is currently only available via API (XRRP, HTTP(s), SOAP, XML-RPC, SMTP). Unfortunately it's not available via EPP.
  • Since the minimum price of a domain must be equal or higher to 90.00 USD, you might want to use the API command ConvertCurrency to convert 90.00 USD in a currency of your choice.
  • Our Aftermarket System is available in our OT&E as well. Sedo requires a special account key so you can access their testing environment. This account key can be requested through us by Sedo directly. Please contact us directly.


Of course, if you have any questions on the RRPproxy Aftermarket System please contact us directly at support@rrpproxy.net.

Aftermarket Account Management

Prior to selling or buying domains throuth the RRPproxy Aftermarket system, you need to add your Aftermarket Account(s) inside your RRPproxy account. You can manage your Aftermarket Accounts by adding, modifying and removing them and check their current status. Each Aftermarket Account entered into the RRPproxy Aftermarket system is identified with an unique ID, an alphanumerical random string of 10 characters. For easier identification a freetext can be applied for each Aftermarket Account.

The “Account Key" for your Aftermarket Account can be obtained at the respective Aftermarket Provider. For Sedo, please log in to your Account at sedo.com and have a look at "My Sedo" -> "My Account" -> "Account Settings” -> “Registrar Listing ID”.

When adding a Sedo Aftermarket Account into the RRPproxy Aftermarket System, the owner of the Sedo Account receives an email from Sedo.

AddAftermarketAccount: Add an Aftermarket Account

To add your Aftermarket-Account via API, please use the command AddAftermarketAccount:

[COMMAND]
command=AddAftermarketAccount
accountkey=<TEXT>                 (mandatory, your Aftermarket Account key)
description=<TEXT>                (optional, freetext for easier identification)
provider=sedo|<NULL>              (defaults to "sedo")
EOF
[RESPONSE]
property[aftermarketaccount][0] = <TEXT>    (The Aftermarket Account ID, an alphanumerical random string of 10 characters)
EOF

ModifyAftermarketAccount: Modify an Aftermarket Account

To change your Aftermarket Account Key or the description associated with the respective Aftermarket Account via API, please use the command ModifyAftermarketAccount:

[COMMAND]
command=ModifyAftermarketAccount
aftermarketaccount=<TEXT>   (mandatory, ID for the Aftermarket Account to be modified, alphanumerical random string of 10 characters)
accountkey=<TEXT>|<NULL>    (optional, if the Account Key changed at the Aftermarket Provider and a different key is provided, the command 
                            will return an error. If this parameter is left empty, it won’t be changed in your RRPproxy account)
description=<TEXT>          (optional, freetext for easier identification. Will be overwritten if this parameter is passed along without content)
EOF

DeleteAftermarketAccount: Remove an Aftermarket Account

To remove access to an Aftermarket Account via your RRPproxy account. If domains are still listed, they will be deactivated at the respective Aftermarket Provider.

[COMMAND]
command=DeleteAftermarketAccount
aftermarketaccount=<TEXT>          (identifier for the Aftermarket Account to be modified, alphanumerical random string of 10 characters)
EOF

StatusAftermarketAccount: Status of an Aftermarket Account

StatusAftermarketAccount shows the total number of domains currently listed, Account Key, Description, Aftermarket Provider of an Aftermarket Account. Furthermore it shows if the Login to the Aftermarket Provider was successful (1) or unsuccessful (0). The Login will be shown as unsuccessful if the Account Key has been changed, for example directly at the Aftermarket Provider.

[COMMAND]
command=StatusAftermarketAccount
aftermarketaccount=<TEXT>          (identifier for the Aftermarket Account to be modified, alphanumerical random string of 10 characters)
EOF
[RESPONSE]
property[aftermarketaccount][0] = <TEXT>
property[accountkey][0] = <TEXT>
property[description][0] = <TEXT>
property[listed domains][0] = <INT> (how many domains are currently listed for sale with this Aftermarket Account)
property[login successful][0] = 0|1 (Shows if the Login to the Aftermarket Provider was successful (1) or unsuccessful (0).
				    Unsuccessful if the Account Key has been changed, for example directly at the Aftermarket Provider.)
property[provider][0] = sedo
EOF

QueryAftermarketAccountList: List your Aftermarket Accounts

A list of all Aftermarket Accounts in your RRPproxy Account

[COMMAND]
command=QueryAftermarketAccountList
wide=1|<NULL>                       (optional)
aftermarketaccount=<PATTERN>|<NULL> (optional)
description=<PATTERN>|<NULL>        (optional)
accountkey=<PATTERN>|<NULL>         (optional)
listeddomains=<PATTERN>|<NULL>      (optional)
provider=<PATTERN>|<NULL>           (optional)
first=<INT>|<NULL>                  (optional)
limit=<INT>|<NULL>                  (optional)
orderby=<TEXT>|<NULL>               (optional)
order=asc|desc|<NULL>               (optional)
EOF
[RESPONSE]
property[aftermarketaccount][0] = <TEXT>
property[description][0] = <TEXT>
property[accountkey][0] = <TEXT>
property[listed domains][0] = <INT> (Shows how many domains are currently listed for sale with this Aftermarket Account)
property[login successful][0] = 0|1 (Shows if the Login to the Aftermarket Provider was successful (1) or unsuccessful (0).
				    Unsuccessful if the Account Key has been changed, for example directly at the Aftermarket Provider.)
property[provider][0] = sedo        (the respective Aftermarket Provider)
property[count][0] = <INT>
property[first][0] = <INT>
property[last][0] = <INT>
property[limit][0] = <INT>
property[total][0] = <INT>
EOF

List Domains for sale through the RRPproxy Aftermarket System

Domains can be offered as direct sale with a fixed price (buy_now):

  • buy_now: The domain will be offered at a set price on the aftermarket, a buyer can buy the domain directly without intervention of the seller.

After listing a domain for sale in the Aftermarket System, a token will be returned, which identifies the domain during each unique selling or listing process. This token needs to be stated as parameter for the commands ModifyAftermarketDomain, StatusAftermarketDomain and DeleteAftermarketDomain.

After a domain has been added to the Aftermarket System, a Form Of Authorisation (FOA) email will be sent to the Admin Contact(s) of the respective domain(s). If several domains with the same Admin Contact are added, only one FOA email for these domains will be sent.

The FOA email contains a link including an approval code to aftermarketapproval.com to activate the listing. The respective URL for approving Sedo listings is http://sedo.aftermarketapproval.com/

Furthermore, approving the FOA email also approves the transfer after a successful sale, i.e. no further FOA email for the outgoing transfer will be sent.

Once the Admin Contact approved the listing, the respective domain(s) will be submitted for listing at the selected provider. If after 5 days no approval is received, the domain will automatically be removed from the Aftermarket System in RRPproxy.


AddAftermarketDomain: Add a Domain listing

Adding a Domain for selling via the Aftermarket System requires the statement of:

  • the Domain name
  • Identifier of the Aftermarket Account
  • Price, a minimum of 90.00 USD is required
  • the type of listing, buy_now (price is fixed)
  • the Aftermarket Provider

The command always returns a token, which identifies the listing.

After a domain has been added to the Aftermarket System, a Form Of Authorisation (FOA) email will be sent to the Admin Contacts of the respective domain. If several domains with the same Admin Contact are added, only one FOA email for these domains will be sent.

The FOA email contains a link including an approval code to aftermarketapproval.com to activate the listing. The respective URL for approving Sedo listings is http://sedo.aftermarketapproval.com/

Once the Admin Contact approved the listing, the resepective domain(s) will be submitted for listing at the selected provider. If after 5 days no approval is received, the domain will automatically be removed from the Aftermarket System in RRPproxy.

[COMMAND]
command=AddAftermarketDomain
domain=<DOMAIN>                  (The Domain you'd like to list.)
 - or
domainX=<DOMAIN>                 (In case you'd like to list up to 256 Domains with one command, specify them with domain0, domain1 ... domain255)
aftermarketaccount=<TEXT>        (Identifier of the Account where the domain should be listed)
price=<DECIMAL>                  (Price for the listed Domain. Format XX.XX, decimals always need to be stated. A minimum price of 90.00 USD is required.)
- or -
priceX=<DECIMAL>                 (In case you'd like to list several Domains with one command, specify their respective prices with price0, price1 ... price255.)
listingtype=buy_now              (Price is fixed. Defaults to buy_now if not stated otherwise.)
provider=sedo                    (The Aftermarket Provider, where the Domain(s) shall be listed. Currently only Sedo available.)
EOF

[RESPONSE]
property[aftermarketdomain][n] = <DOMAIN>
property[status][n] = foa_pending
property[token][n] = <TEXT>
EOF

ModifyAftermarketDomain: Modify a Domain listing

The listing at the Aftermarket Provider can be changed by updating the price, the type of listing or temporarily remove the domain from the listing.

[COMMAND]
command=ModifyAftermarketDomain
token=<TEXT>                     (Identifier token for this listing.)
price=<DECIMAL>                  (Price for the listed Domain. Format XX.XX, decimals always need to be stated. A minimum price of 90.00 USD is required.) 
listingtype=buy_now              (Offers can be made. Defaults to buy_now if not stated otherwise.)
listed=0|1                       (0 = Remove domain from listing, but keep it at the Aftermarket Provider; 1 = list the domain for sale.)
EOF

[RESPONSE]
property[aftermarketdomain][0] = <DOMAIN>
property[status][0] = listed|pending     (pending: Domain ist known to Aftermarket Provider but not listed for sale; listed: Domain ist listed for sale.)
EOF

StatusAftermarketDomain: Status of a Domain listing

Requires the identifier token for a listing. Returns the listed domain, price, status at Aftermarket Provider, listing type and Aftermarket Provider.

[COMMAND]
command=StatusAftermarketDomain
token=<TEXT>                                    (Identifier token for this listing.)
EOF

[RESPONSE]
property[aftermarketaccount][0] = <TEXT>
property[token][0] = <TEXT>
property[domain][0] = <DOMAIN>
property[price][0] = <DECIMAL>
property[status][0] = pending|listed            (pending: Domain ist known to Aftermarket Provider but not listed for sale, listed: Domain ist listed for sale)
property[listingtype][0] = buy_now              (Price is fixed. Defaults to buy_now if not stated otherwise.)
property[provider][0] = sedo

DeleteAftermarketDomain: Remove a Domain from listing

To permanently remove a domain from the Aftermarket System and not only temporarily remove it from the listing, this command may be used:

[COMMAND]
command=DeleteAftermarketDomain
token=<TEXT>
EOF

[RESPONSE]
property[status][0] = deleted
EOF


QueryAftermarketDomainList: List all Domains currently listed for sale

Returns a list of all Domains in your RRPproxy account that are currently listed for sale through the Aftermarket System. Offers parameters to narrow down the resulting response.

[COMMAND]
command=QueryAftermarketDomainList
aftermarketaccount=<TEXT>|<NULL>   (optional, Aftermarket Account ID)
token=<PATTERN>|<NULL>             (optional, ID of a domain listing)
domain=<PATTERN>|<NULL>            (optional, full domain name)
price=<PATTERN>|<NULL>             (optional, price format x.xx without currency)
status=<PATTERN>|<NULL>            (optional, pending or listed)
listingtype=<PATTERN>|<NULL>       (optional, buy_now. Defaults to buy_now if not stated otherwise.)
first=<INT>|<NULL>                 (optional)
limit=<INT>|<NULL>                 (optional)
orderby=<TEXT>|<NULL>              (optional)
order=asc|desc|<NULL>              (optional)

[RESPONSE]
property[aftermarketaccount][0] = <TEXT>
property[token][n] = <TEXT>
property[domain][n] = <DOMAIN>
property[price][n] = <DECIMAL>
property[status][0] = pending|listed            (pending: Domain ist known to Aftermarket Provider but not listed for sale, listed: Domain ist listed for sale)
property[listingtype][0] = buy_now              (Price is fixed. Defaults to buy_now if not stated otherwise.)
property[provider][n] = sedo
property[count][0] = <INT>
property[first][0] = <INT>
property[last][0] = <INT>
property[limit][0] = <INT>
property[total][0] = <INT>

The Selling Process

After domains have been listed for sale, this section covers to actual selling process.

  • Direct Sale: Refers to a listing of a domain using listingtype=buy_now. Directly processes the sale as soon as a valid bid is received.

Direct Sale (buy_now)

When a bid is received for a Domain listed for direct sale (listingtype=buy_now), you'll receive a BID_SUCCESS event:

AFTERMARKET_BID:BID_SUCCESS
(token:<token>;domain:<domain>;bid:<bid>)
A bid for a domain was successful and is now available in the reseller - account.

Basically that's it, you successfully sold or bought a domain. Congratulations!
You'll receive a respective TRANSFER_SUCCESS event for the incoming domain, or a FOREIGN_TRANSFER_SUCCESS event for the outgoing domain.

Buying a Domain with the RRPproxy Aftermarket

To buy a domain in the RRPproxy Aftermarket, a search for available domains at Aftermarket Providers must be done to determine the price of a domain. This can be done using the QueryAftermarketList command. To allow a domain be put into a shopping cart on websites, the command ReserveDomain may be utilised, which reserves a domain exclusively for an Aftermarket Account for 8 hours, and up to 96 hours in total. This step can be skipped and BuyDomain can be used directly to initiate the process of buying a domain from the aftermarket.

In case ReserveDomain was used, please note the TOKEN returned by the command. To successfully acquire the domain this token must be stated in the following BuyDomain command.

The section of the aftermarket, where a domain is listed determines the next step.

If the domain was listed as a Direct Sale ("buy_now"), a transfer will be initiated to put the domain into your account. After a successful transfer, the domain will be modified to reflect the new owner given by CONTACT in the original BuyDomain call.

Note: The RRPproxy Aftermarket System works with your account currency. The minimum price of 90.00 USD must be equal converted to your account currency.

QueryAftermarketList

Search domains in the aftermarket. The search term is given by "KEYWORD".

[COMMAND]
COMMAND = QueryAftermarketList
KEYWORD = <TEXT>      (Return domains belonging to this keyword)
MINLENGTH = <INT>     (Search only for domains longer than this, optional)
MAXLENGTH = <INT>     (Search only for domains shorter than this, optional)
MINPRICE = <DECIMAL>  (Search only for domains more expensive than this, optional)
MAXPRICE = <DECIMAL>  (Search only for domains less expensive than this, optional)
FILTER = <TEXT>       (Don't search for domains containing this, optional)
LISTINGTYPE = <TEXT>  (Type of listing; defaults to buy_now = fixed price, optional. Defaults to buy_now if not stated otherwise.)
LIMIT = <INT>         (Show only this many items in the response, optional)
PROVIDER = <TEXT>     (Which Aftermarket Provider to search: currently only Sedo, optional).
EOF

[RESPONSE]
code = <INT>
description = <TEXT> 
property[DOMAIN][n] = <DOMAIN>        (Domain for sale)
property[MINIMUM BID][n] = <DECIMAL>  (The minimum amount the domain is for sale)
property[BID][n] = <DECIMAL>          (The amount the domain is available for direct sale)
property[LISTING TYPE][n] = <TEXT>    (The type of listing on the aftermarket platform, buy_now.  Defaults to buy_now if not stated otherwise.)
property[PROVIDER][n] = <TEXT>        (The provider this listing is from)
EOF

ReserveDomain

Reserve a domain in the aftermarket. This is a non-binding offer. To later buy the domain, use BuyDomain with the token returned from this command.
The domain will be reserved for 8 hours and the command ReserveDomain can be used several times up to an amount of 96 hours. Afterwards it will be released and is not reserved any more.

[COMMAND]
COMMAND = ReserveDomain
DOMAIN = <DOMAIN>   (The domain to be bought)
BID = <DECIMAL>     (Price to buy the domain for, in your account currency. Format XX.XX, decimals always need to be stated.)
PROVIDER = sedo     (Where to buy the domain)
CONTACT = <CONTACT> (Contact handle used to buy the domain, will be used for all contact handles after the transfer)
EOF

[RESPONSE]
code = <INT>
description = <TEXT>
property[TOKEN][0] = <TEXT>  (Token to identify this process in our system)
property[PROVIDER][0] = sedo (Provider, where the process was initialized)
EOF

BuyDomain

Start a bid on a domain or directly buy a domain in the aftermarket. A domain may be reserved previously via ReserveDomain. If the buying process uses direct_buy, no further action is necessary.

[COMMAND]
COMMAND = BuyDomain
DOMAIN = <DOMAIN>   (The domain to be bought, mandatory)
BID = <DECIMAL>     (Price to buy the domain for, in your account currency. Format XX.XX, decimals always need to be stated.)
PROVIDER = sedo     (Where to buy the domain)
CONTACT = <CONTACT> (Contact handle used to buy the domain, will be used for all contact handles after the transfer)
TOKEN = <TEXT>      (Token used to reserve a domain, optional but necessary if the domain has been reserved previously)
EOF

[RESPONSE]
code = <INT>
description = <TEXT>
property[STATUS][0] = pending|processing  (pending: waiting for accept/deny/counter offer of seller; applies especially to biddings
                                           processing: domain has been bought successfully and will now be moved)
property[BIDDING][0] = 0|1                (0: buy_now, Domain has been bought, 1: make_offer, Domain is in bidding)
property[TOKEN][0] = <TEXT>               (Token, identifier of the buy process. Necessary for further bids in biddings.)
property[PROVIDER][0] = sedo              (Used provider, currently only Sedo available.)
EOF

QueryAftermarketBidList

Query all initiated aftermarket processes in your RRPproxy account.

[COMMAND]
COMMAND = QueryAftermarketBidList
FIRST = <INT>  (Start the output of results from this item, optional)
LIMIT = <INT>  (Show only this many items in the response, optional)
EOF

[RESPONSE]
code = <INT>
description = <TEXT>
property[TOKEN][0] = <TEXT>    (matching token for this bid)
property[DOMAIN][0] = <DOMAIN> (domain in question)
property[BID][0] = <DECIMAL>   (current highest bid in your account currency)
property[BIDSTATUS][0] = INITIATED|FAILED|SUCCESS|WAITINGFORAUTH|INTRANSFER (1)
property[PROVIDER][0] = sedo   (Aftermarket Provider, currently only Sedo available)
property[COUNT][0] = <INT>     (Total number of aftermarket processes shown)
property[FIRST][0] = <INT>     (Pointer to the first shown ID)
property[LAST][0] = <INT>      (Pointer to the last shown ID)
property[LIMIT][0] = <INT>     (The limit given in the command)
property[TOTAL][0] = <INT>     (Total number of aftermarket processes)
EOF

(1) BIDSTATUS: Status of the process

Value Description
INITIATED The process was started
FAILED The process failed
SUCCESS The process was successfully completed
WAITINGFORAUTH The system is waiting to get the AuthCode from the provider
INTRANSFER The transfer was initiated

Events

AFTERMARKET_BID:BID_ACCEPTED
(token:<token>;domain:<domain>;bid:<bid>)

Received by the buyer: A bid made for a domain was accepted and the domain has been transferred to the winning RRPproxy reseller account.


AFTERMARKET_BID:BID_INCOMING
(token:<token>;domain:<domain>;bid:<bid>)

Received by the seller: For a domain you are selling there is a bid incoming (respond with AftermarketBid).


AFTERMARKET_BID:BID_SUCCESS
(token:<token>;domain:<domain>;bid:<bid>)

Can be received both by seller and buyer: A bid for a domain was successful and it is now is available in your RRPproxy reseller account.

FAQ

Question: Can Domains outside my RRPproxy account be listed?
Answer: Unfortunately, the answer is no. We can only make sure the listed domains are under your control as long as they are inside your account. For domains outside your account we can not assure they are under your full control.

Question: Can anybody see my domain listings at the respective Aftermarket Provider?
Answer: Yes. Your listings will be visible for everybody.

Question: Can domains be traded between two different RRPproxy accounts in the Aftermarket System?
Answer: Yes, this is fully supported.

Question: Can I list one domain multiple times at Sedo?
Answer: This is not possible. At Sedo one domain can only be listed once. However, you can list the same domain at other Aftermarket Providers as well.

Question: How am I notified that a bid/offer has been placed for a listed domain?
Answer: You will receive a BID_INCOMING Event: AFTERMARKET_BID:BID_INCOMING

Question: Instead of having to use the token, is stating Domain name also possible?
Answer: No, the token is necessary because several listing instances can exist for one Domain in the Aftermarket System. For example: An inactive listing for direct buy and an active listing for bidding. Also, as soon as additional Aftermarket Providers are available these tokens are necessary to distinguish listings of same domains at different Aftermarket Providers.

Question: Why do I have to set a minimum price of 90.00 USD?
Answer: This is a requirement of Sedo.

Question: Is a listed domain locked?
Answer: Yes. All domains listed in the RRPproxy Aftermarket are locked, domain modifications, transfers and deletions are not possible.

Question: Why am I getting the error message "Domain listed on aftermarket, please remove first"?
Answer: You'll receive this error message when trying to modify (ModifyDomain), transfer (TransferDomain) or delete (DeleteDomain) a domain which is listed in the RRPproxy Aftermarket. If you would like to perform such an action, please delist the respective domain first.

Question: Why is no EPP support available for the RRPproxy Aftermarket?
Answer: EPP is designed for domain management. Adding EPP support for the RRPproxy Aftermarket would require the development of many EPP extensions which would be far beyond any standardisation.

Personal tools
Namespaces

Variants
Actions
Resources
new gTLDs
Products
New Users
General
Tools