Link to our demo: https://unstoppabledomains.github.io/reseller-demo/
This Demo show in particular how others can use UD API to resell .ZIL domains
Enables domain purchase.
Requires:
User email
order
parameters:
payment
any of: {type: ‘reseller’} - for reseller payback method
{type: ‘stripe’, tokenId: } - for stripe payment method
domains[].name
to be bought
domains[].owner
to own the domain after the purchase
domains[].resolution
resolver information on the domain name that contains a crypto address for each currency
Returns:
orderNumber
to track the order status and form support requests to UD
subtotal
that reseller will be charged for the order
items[]
purchased:
name
of the domain
type
of the item (currently only ZNS_DOMAIN
)
Whether a domain is in the test
space (aka reseller-test-*
)
blockchain.status
of the transaction: “PENDING”, “MINED”, “CANCELED”.
! IMPORTANT:
The blockchain needs time before a transaction is mined. In rare cases, it is possible for someone to front run your purchase, which would result in an order being cancelled. We expect this to happen in less than 1 out of 10,000 cases. Blockchain doesn’t currently support any locking functionality for an upcoming purchase. Please make sure you are using the “Order Status” endpoint and wait until the transaction is mined.
The API currently supports a single domain purchase at a time. UD will extend support to multiple domains in the future.
Order parameters JSON Schema: https://gist.github.com/bogdan/f9911f4022c6441cbe40ff93811e1ea2 About JSON Schema: http://json-schema.org/
Examples:
As a recommended payment method we suggest to use Stripe. You will need to obtain the stripe token and send it to us as POST request to https://unstoppabledomains.com/api/v1/resellers/udtesting/users/[email protected]/orders
BODY
{ "order": { "payment": { "type": "stripe", "tokenId": "tok_1FAeVFG8PQyZCUJhJp7emswP" }, "domains": [ { "name": "reseller-test-udtesting-17829.zil", "owner": "0xa823a39d2d5d2b981a10ca8f0516e6eaff78bdcf", "resolution": { "crypto": { "ZIL": { "address": "0xe568f2BB42A77F6508911290d581B3Af107b1e4B" }, "ETH": { "address": "0x20B4564DEB7AF89ece828d843D0Ac2c16934a23e" } } } } ] } }
{
"order": {
"orderNumber": "-Lmz2FnYCUZdVe_foJ2M",
"subtotal": 10,
"test": true,
"payment": {
"type": "stripe"
},
"items": [
{
"type": "ZNS_DOMAIN",
"name": "reseller-test-udtesting-17829.zil",
"blockchain": {
"status": "PENDING"
}
}
]
}
}
As an alternative UD trust resellers with any payment process they decided to go. If this is the case then reseller need to use the example bellow to make a buy call. We will contact reseller on a monthly basis chargin them for the domain they sold.
https://unstoppabledomains.com/api/v1/resellers/udtesting/users/[email protected]/orders
BODY
{ "order": { "domains": [ { "name": "reseller-test-udtesting-24287.zil", "owner": "0xa823a39d2d5d2b981a10ca8f0516e6eaff78bdcf", "resolution": { "crypto": { "ZIL": { "address": "0xe568f2BB42A77F6508911290d581B3Af107b1e4B" }, "ETH": { "address": "0x20B4564DEB7AF89ece828d843D0Ac2c16934a23e" } } } } ] } }
{
"order": {
"orderNumber": "-Lm9wiYytgrpf4YCWYv6",
"subtotal": 10,
"items": [
{
"type": "ZNS_DOMAIN",
"name": "reseller-test-udtesting-24287.zil",
"test": true,
"blockchain": {
"status": “PENDING”
}
}
]
}
}