Custom domains

By default your customer-facing pages run on Paysio URLs. Connecting a custom domain serves them from your own web address instead, so checkout, links, and your store all appear on your brand rather than paysio.com. You set this up in Settings > Custom Domain.

Adding your domain

Two requirements to know first:

  • Use a subdomain, such as pay.yourdomain.com or shop.yourdomain.com. Apex domains (yourdomain.com with no subdomain) are not supported.
  • Your domain must be managed on Cloudflare, so Paysio can provision the secure certificate automatically.

To connect it:

  1. Enter your subdomain and click Connect.
  2. Paysio shows you a CNAME record to add at your DNS provider: a Name / Host (your subdomain) that points to the target Paysio gives you. Add it exactly as shown.
  3. If Paysio also shows an optional TXT record, add it to verify ownership before the CNAME takes effect.

Verification and SSL

After you add the record, the domain has a status:

  • Pending: Paysio is waiting for your DNS change to propagate. DNS can take a little while, so this is normal at first.
  • Active: your domain is verified and live.
  • Error: something is off with the DNS record. Recheck it against what Paysio shows.

Click Refresh status to re-check at any time. The SSL certificate is issued for you automatically once the domain verifies, so your custom domain is served securely over HTTPS with nothing extra to do.

Apple Pay on your domain

Apple Pay needs to confirm you own the domain before it will run on it. This uses a domain association file served at /.well-known/apple-developer-merchantid-domain-association.

Once your domain is connected, the Apple Pay Domain Verification section appears. Download the association file from your payment gateway's dashboard (in NMI, under Apple Pay > Domain Registration) and upload it here. Paysio then serves it at the right path so Apple Pay works on your custom domain.

What uses your domain

Once active, your custom domain replaces the Paysio URL across your customer-facing pages, including your payment links, the checkout and confirmation pages, the customer portal, and your storefront. Your customers see your brand end to end, while the Paysio dashboard itself stays on its normal address.

Troubleshooting

  • Stuck on Pending: DNS changes take time to spread. Wait a bit and click Refresh status. If it stays pending for a long time, double-check the record was saved at your DNS provider.
  • Error status: the CNAME does not match. Confirm the Name/Host and the "points to" value are exactly what Paysio shows, with no typos or extra characters.
  • Apex domain rejected: use a subdomain like pay.yourdomain.com rather than the bare domain.
  • SSL not provisioning: make sure the domain is managed on Cloudflare, which is required for automatic certificates.

You can always Remove domain to disconnect and go back to the Paysio URL, or to start over.