Checkout
You can specify a brand domain on the payment page from which your customers will send payments. When Speed payment resources like payment links, checkout links, and others are created, your customer is directed to a payment page with the checkout.tryspeed.com domain by default. Change this default domain into your custom domain for a branded URL experience.
Discover how to bring your custom domain to the payment page.
Log in to your account and follow the steps below to set up your custom checkout domain.
Step 1. Adding your custom domain to the Speed Web application
First decide what subdomain to use with your payment page. The domain must be a subdomain. If your domain is example.com, we recommend selecting a subdomain that aligns with your business name (e.g., checkout.example.com). You can replace checkout with anything you like, as long as it's a valid subdomain. You can’t use a path like example.com/checkout.
After you decide on the domain, visit the custom domains settings page to start the domain connection process. Complete the following steps to add your custom domain:
- Go to
Settings > Business Settings > Custom domain
and enter the domain you want. Except for the default "tryspeed.com" domain, you can add only one more custom domain. - Click
Add Domain
after entering a valid domain name. - DNS records will be displayed in a pop-up window. These must be entered into your DNS server.
- Click the
Verify Domain
button to compare the DNS records entered in the DNS server with those generated here and verify your domain.
These DNS records are required to ensure both your domain ownership and reliable redirection from your domain.
Step 2: Creating DNS records for verification.
Find out which provider is in charge of managing your DNS records to get started. Use a browser-based tool, go to MXLookup's DNS Lookup tool, enter your domain, and use it to find out who your DNS provider is if you are unsure.
Below are the Standard instructions to create the DNS records. It may vary depending on your service provider. Please find the instructions for the specific service provider here.
- Sign in to your DNS provider.
- Most DNS providers have a control panel you can sign into to manage your DNS. Find your provider’s control panel page.
- Find the page through your control panel to manage the DNS for your domain.
- In the DNS control panel, add new records that map your subdomain to Speed. Most DNS providers ask you for the record type, name, value, and TTL or expiration.
- Create 2 CNAME records as mentioned in the table below.
- If you have issues with any of the steps, please check this out.
Enter these values and save the new DNS record:
FIELD | INSTRUCTIONS | DESCRIPTION |
---|---|---|
Name | Copy the correct name of the record from the Speed DNS popup window. | This specifies which DNS record this is. |
Type | Select CNAME from the dropdown | This specifies what kind of DNS record this is. |
Value | Copy the correct value of the record from the Speed DNS popup window. | This is a long, unique string used for domain verification. |
TTL/Expiry | Enter 300 | An expiration of 5 minutes (300 seconds) is OK. Your DNS provider might not allow you to change the TTL value. If this field is missing or you can’t change it, it’s safe to ignore this part of the configuration. |
Step 3: Testing your domain
You will see the "ready" state after your DNS records have been verified. You can test your domain before activating it if you choose.
- Sign into your test account.
- Go to the Custom Domains settings page to activate your custom domain in test mode. You will receive an email notification for the same.
- Create a payment resource like a checkout link, checkout session, or payment link in the test mode.
- Visit the payment resource URL and check if the payment page opens up with your custom domain in the address bar of your browser.
Here, your custom domain is only being used for checkout sessions in test mode. No links will be impacted in live mode by this.
Domain Statuses
The status will be as follows for a custom checkout domain:
- ready
- If all the records match those on the DNS server, the domain's status changes to ready.
- connecting
- Once a domain is added, its status remains "connecting" until it is verified.
Step 4: Activate your domain in live mode
Repeat the steps done in test mode to start accepting payment in live mode with your custom domain in the URL.
🚫 Client-side integration might not be compatible with a custom domain.Disconnect domain
You can delete a domain when you no longer use it. Any custom domain, regardless of whether it is connecting
or ready
, can be removed. You cannot remove the default domain.
To remove your custom domain, follow these steps.
- Go to the Custom Domains settings page.
- Click the
disconnect
button. - Read the popup confirmation, and click disconnect to confirm the removal.
Once disconnected, it will need to undergo the verification process again.
How does it work with different Speed payment resources?
- Checkout link:
Your unique domain is in the checkout link URL that will take your customer to a payment page. Therefore, be sure there are no active checkout links when you disconnect a domain because they won't function after the domain is disconnected. - Payment Link:
The URL for a payment link (i.e.,buy.tryspeed.com/pay/{checkout_session_id}
) is not yet customizable. However, this URL directs your customer to a payment page that has a customizable URL (i.e.,checkout.tryspeed/pay/{checkout_session_id}
). Hence, disconnecting a domain will not affect your active payment links. - Checkout Session:
You receive two URLs (default_url and url) in the response when you create a checkout session. Default_url will contain the checkout_session URL with the default domain (checkout.tryspeed/pay/{checkout_session_id}
). And url will have your custom checkout domain. Here, disconnecting your custom domain will affect the url, not the defaut_url.
Instructions for popular providers
DNS record changes can take up to 3-4 hours to be confirmed. The process for adding DNS records to your domain's DNS server differs depending on your service provider. Refer the below-mentioned documentation from some popular providers for specific instructions.
We will verify your newly created records. Next, we create TLS certificates for your subdomain, set up the correct CDN routing, and send you an email notification because the domain is ready for you to activate it.
Troubleshoot DNS issues
If your domain hasn’t been verified, try the following:
- Correct any typos.
- Make sure you don’t have any records that share the same name as the provided CNAME records.
- Make sure the added record names don’t include your domain twice. Some providers automatically append DNS record names with the domain name. For example, to create a record with the name bounce.example.com, enter only bounce in the name field.
- Check that the DNS records are published. You can verify this by using a DNS lookup tool, which displays the published records for your domain.
If you’ve tried all of our troubleshooting recommendations and are still having trouble verifying your domain, contact your DNS provider.
Updated 7 months ago