Free FIO Address

• Every account is entitled to 1 (make this nev var) FIO Address registration for free.

• If user is not logged, show 1 FIO Address free. If they log-in and already have free address, an error will be presented.

• Free address count should be tracked server-side

USDC Price Computation

• USDC equivalent prices are computed as follows:

  • run get_fee for register_fio_domain and/or register_fio_address

  • convert fee using rate of exchange (ROE) feed (same as used by Reg site)

• The ROE should be updated only every 30 minutes and stored in session to avoid constant variations in price

• Show USDC price with 2 decimal precision, e.g. 1.23 USDC

FIO Price Display

• Show FIO price with 2 decimal precision, e.g. 1.23 FIO

FCH Registration (Free or Paid)

FCH

FIO Crypto Handle Registration

bob@hodl

FIO Crypto Handle Registration

Domain Registration

Domain

FIO Domain Registration

amazon

FIO Domain Registration

FCH and Domain Registration

FCH

FIO Crypto Handle and Domain Registration

bob@hodl

FIO Crypto Handle and Domain Registration

Domain Renewal

Domain

FIO Domain Renewal

amazon

FIO Domain Renewal

Add Bundles

FCH

Add Bundled Transactions

bob@hodl

Add 100 Bundled Transactions

Free Cart

No Payment Required

Image Removed

Image Removed

These paths already exists and can persist now for single free crypto handle transactions.

• Search View

  • Display

    • Single FIO Crypto Handle in Cart

    • Checkout CTA

      • In the case where the user is registering a single free crypto handle, the user will bypass the secondary cart view and proceed directly to the make purchase view with no form of needed payment to complete their transaction.

• Cart View

  • Display

    • Single FIO Crypto Handle in Cart

    • Complete Transaction CTA

      • In the event that the user closes the purchase view and only a single free handle is in the cart, the user is shown the cart view with with the complete transaction CTA with directs the user the the make purchase view with no form of needed payment to complete their transaction.

Paid Cart

Pay with FIO Cart

Image Removed

Pay with non-FIO Cart

Image Removed

Price Change

Image Removed

FIO Address Selection

Image Added

• Versions

  • Authenticated header

  • Non-authenticated header

• Collect

  • Username

    • X appears when first character is entered

      • When licked it clears the content and disappears

  • Domain

    • Show domains owned by user in any FIO Wallet (sorted alphabetically)

    • Obtain the list from Registration Site API (sorted as returned)

    • Default to first domain in list

• Validate

  • Username

    • Convert onfocusout

      • Convert to lowercase

    • Validate onfocusout

      • On validation error

        • Display error message:

          • Username only allows letters, numbers and dash

          • This FIO Address is already registered.

    • Validation rules

      • Format: See validation rules

      • Availability: Obtain the from avail_check

  • Domain

    • Convert onfocusout

      • Convert to lowercase

    • Validate onfocusout

      • On validation error

        • Display error message:

          • Unfortunately the domain name you have selected is not available. Please select an alternative.

    • Validation rules

      • Format: See validation rules

      • Availability: Obtain the from avail_check

• Display

  • Item price - see Free FIO Address and USDC Price Computation

  • Domain pull-down

    • Add “Add Custom Domain” item at the end

      • On click

        • Display domain field as entry field

          • Show X - closes the entry field and display original pull-down

  • Search icon

    • On click display re-run validation

  • Available/error banner

    • Display when FIO Address is available

    • Display on validation error

  • FIO Address item and descriptor

  • Price - see Free FIO Address and USDC Price Computation

  • Add to Cart link - display when FIO Address is available

    • On click

      • Add FIO Address to cart

      • Replace Add to Cart with Added

      • Add X

        • On click remove FIO Address from cart and remove this section

    • If user searches for a new FIO Address this section disappears, even if FIO Address was added to cart.

  • Purchase Domain

    • On click

      • Display FIO Domain Selection Page

FIO Domain Selection

Image Added

• Versions

  • Authenticated header

  • Non-authenticated header

• Collect

  • Domain

• Validate

  • Domain

    • Convert onfocusout

      • Convert to lowercase

    • Validate onfocusout

      • On validation error

        • Display error message:

          • Unfortunately the domain name you have selected is not available. Please select an alternative.

    • Validation rules

      • Format: See validation rules

      • Availability: Obtain the from avail_check

• Display

  • Search icon

    • On click display re-run validation

  • Available/error banner

    • Display when FIO Domain is available

    • Display on validation error

  • FIO Domain item and descriptor

  • Price - see Free FIO Address and USDC Price Computation

  • Add to Cart link - display when FIO Domain is available

    • On click

      • Add FIO Domain to cart

      • Replace Add to Cart with Added

      • Add X

        • On click remove FIO Domain from cart and remove this section

  • Register and Address

    • On click

      • Display FIO Address Selection Page

Mini-cart

Image Added

• Display

  • Items and Descriptors

    • Price - see Free FIO Address and USDC Price Computation

  • Checkout Now link - display when cart is not empty, hide when empty

    • On click

      • User has only 1 Free FIO Address in mini-cart

        • Display Purchase Page

      • Otherwise

        • Display Cart

      can contain FREE and paid items

  • Total cost

    • Sum of all FIO Addresses

  • Price change warning

    • Display if price has changed from previous page

      • • Page

      • If user not authenticated, display Create Account Page as overlay and all other registration steps as overlay.

  • Trash can icon

    • On click

      • On click remove FIO Address from cart

Template

Image Added

Image Added

Image Added

• Display

  • Main Cart

    • Number of items in Cart

    • Items and Descriptors

      • Price - see Free FIO Address and USDC Price Computation

      • X

        • On click

          • Remove item from Cart

    • Search for more FIO

• • • Crypto Handles?

      • On click

        • Display FIO

• • • • • Domain Selection Page

• • Totals

    • Items and Descriptors

      • Price - see Free FIO Address and USDC Price Computation

  • Main Button - display when cart is not empty, hide when empty

    • If user has sufficient amount of FIO in at least one Wallet

      • Pay with FIO

• • • If only item in cart is a Free FIO Address

      • Main button: Complete Transaction

    • If user does not have

• • • sufficient amount of FIO in

• • • at least one Wallet

      • Pay with

• • • • Credit/Debit Card

    • On click

• • • • Display Purchase Page

      • If user not authenticated, display Create Account Page as overlay and all other registration steps as overlay.

  • Secondary link: Other Payment Options - show only if Pay with FIO Shown

    • On click

      • Display second button Pay with Credit/Debit Card

Pay with FIO

• Display

  • Items and Descriptors

    • Price - see Free FIO Address and USDC Price Computation

  • Totals

    • Items and Descriptors

      • Price - see Free FIO Address and USDC Price Computation

• • Wallet paying

    • FIO Wallet balance

      • FIO as obtained from /get_fio_balance

      • USDC calculated: FIO balance * Total USDC / Total FIO

    • Only display wallets that have sufficient balance

    • If

• • • more than 1 allow for selection

  • Purchase Now button

    • On click

      • Run /get_fee

        • If prices have changed, display Cart page with updated pricing and Pricing update! banner.

      • Check user’s FIO balance

        • If wallet balance is less than purchase amount due, display Cart page with Low Balance banner

      • Collect

        • PIN code

      • Display Transaction Processing Page

• • • • Execute Purchase

      • Display

• • • • Purchase Confirmation Page

Pay with Stripe

• Display

  • Items and Descriptors

    • Price - see Free FIO Address and USDC Price Computation

  • Totals

    • Items and Descriptors

      • Price - see Free FIO Address and USDC Price Computation

  • Wallet assignment

• • • FIO Wallet balance

      • FIO

• • • • as obtained from /get_fio_

• • • • balance

      • USDC calculated: FIO balance * Total USDC / Total FIO

    • If more than 1 allow for selection

  • Pay button

    • On click

      • Run /get_fee

        • If prices have changed, display Cart page with updated pricing and Pricing update! banner.

      • Execute Purchase

      • Display Purchase Confirmation Page

• Collect

  • Use https://stripe.com/docs/payments/accept-a-payment?ui=elements and see Purchase → Pay With Stripe

Free

Image Added

• Same as Pay with FIO except all wallets displayed

Template

• Display

  • Title

    • The title updates automatically based on order status, except

      • Success - Purchased

      • Partial Success - Partial Purchased

  • Transaction Details

    • Product

    • Show product

      • cryptohandle@domainname

    Show product type

    • Domain Registration

    • Domain Renewal

    • Crypto Handle Registration

    • Crypto Handle Renewal

    • Add Bundles

    Crypto Handle and Domain Registration

    Item and descriptor

    • Show cost

      • Show FIO price with 2 decimal precision, e.g. 1.23 FIO

      • Show USDC price - see Free FIO Address and USDC Price Computation

    • TX ID (if available, otherwise do not show row)

      • Show FIO Chain ID with link to explorer which opens a new tab

      • If multiple TX IDs exist list one underneath the other

  • Payment Details

    • Total cost

      • Sum of all items' cost in cart

        • For free state FREE

    • Paid with

      • Free: Do not display

      • FIO: Display the wallet from which the FIO was withdrawn

      • Stripe: Credit card type and last 4 of credit card number, e.g. “Visa ending in 1234”

    • Order Number

      • Display alphanumeric order number

• Action

  • Close or X

    • When clicked display Authenticated Home Page

Pending

• Add rotating circle and Confirmation in Progress blue box notice

  • Confirmation in Progress - Your transaction is currently being confirmed. You do not need to remain on this screen and may close it without disrupting your purchase.

Partial Success

• Separate confirmed and not confirmed items and show Incomplete Purchase red box error.

  • Stripe - FIO Tokens for failing items not transferred to user

    • Incomplete Purchase - There was an error during purchase of some items. As a result we have refunded $XX.XX back to your credit card. Go to your cart to try purchase again.

  • Stripe - FIO Tokens for failing items transferred to user

    • Incomplete Purchase - There was an error during purchase of some items. As a result we have credited 100 FIO Tokens ($5.00) to your wallet. Go to your cart to try purchase using FIO Tokens instead.

  • FIO

    • Incomplete Purchase - There was an error during purchase of some items. No FIO Tokens were deducted from your wallet for the failed items. Go to your cart to try purchase again.

  • FREE

    • Incomplete Purchase - There was an error during purchase of some items. Click close and try again.

• If items failing are belong to multiple categories (e.g. FREE item failed, but also item paid with Stripe) - show multiple boxes

Purchase Error

• Add Purchase Error red box error

  • Stripe

    • Purchase Error - There was an error during purchase. As a result we have refunded the entire amount of order, $XX.XX back to your credit card. Click close and try purchase again.

  • FIO

    • Purchase Error - There was an error during purchase. No FIO Tokens were deducted from your wallet. Click close and try purchase again.

  • FREE

    • Purchase Error - There was an error during purchase. As a result we could not complete your purchase. Click close and try again.

Declined (Stripe)

• Add Payment error red box error

  • Payment Error - The payment was not accepted and as a result the transaction was not processed.

Canceled

• Add blue box notice

  • Canceled - Your transaction has been cancelled.

• Change Paid with to “Not Paid”