在支付宝生态开发（小程序、H5 支付、网页应用）中，** 域名报白（加白名单）** 是上线前的核心环节 —— 未配置白名单，轻则小程序接口请求失败、web-view 页面无法加载，重则用户支付时弹出 “非官方网页” 警告，直接流失订单。本文从场景、步骤、规则到避坑，完整梳理支付宝域名报白全流程，开发者可直接对照操作。

一、为什么必须做支付宝域名报白？

支付宝为保障用户资金与信息安全，对所有外部域名访问执行严格的白名单管控：
小程序场景：线上版本仅允许请求白名单内的服务器域名，内嵌 H5 页面必须配置 H5 域名白名单，否则直接报错、页面白屏支付宝文档中心；
支付场景：H5 支付、网站支付跳转时，未报白的域名会触发 “非支付宝官方网页，请确认是否继续访问” 的安全拦截，大幅降低支付转化率；
接口场景：网页 / 移动应用调用支付宝开放接口，需配置域名校验白名单，避免接口调用被风控拦截。
简单说：不报白，业务无法正常上线；报白不规范，用户体验与支付转化直接受损。

二、三大核心场景：域名报白完整操作步骤

1. 场景 1：支付宝小程序 —— 服务器域名白名单（接口请求）
2. 适用：小程序内通过my.request调用自身后端接口、第三方 API
3. 登录支付宝开放平台控制台：https://open.alipay.com/develop/manage
4. 进入目标小程序 → 左侧菜单栏选择设置 → 开发设置

找到服务器域名白名单（request 合法域名） → 点击添加

填写域名规则（必填）：
必须为HTTPS协议（https://开头，不支持 HTTP）
域名必须完成ICP 备案（个人 / 企业均需备案）
格式：https://api.xxx.com（不能带端口、路径、参数）
提交保存，等待官方审核（几分钟至 1 小时生效）

场景 2：支付宝小程序 ——H5 域名白名单（web-view 内嵌网页）
适用：小程序使用组件加载外部 H5 页面、商城、活动页
同路径进入开发设置 → 找到H5 域名配置 → 点击添加支付宝文档中心

关键步骤：域名所有权验证（必做）

点击下载校验文件（HTML 文件，文件名如519d925a1234a40a41234e76bab48268.html）
将文件上传至待报白域名的服务器根目录，确保可直接访问：
https://www.xxx.com/校验文件名.html

填写域名（https://www.xxx.com）→ 点击验证 → 验证通过后保存支付宝文档中心
注意：H5 域名配置修改后，小程序需重新发版，新版才生效支付宝文档中心
场景 3：网页 / 移动应用 —— 支付域名白名单（解除 “非官方网页” 警告）
适用：网站支付、H5 支付、扫码支付跳转，消除安全拦截提示

1. 1. 方案 A：开放平台配置（基础报白）
   2. 开放平台进入网页 / 移动应用 → 设置 → 开发设置
   3. 找到域名校验白名单 → 点击编辑
   4. 填入业务域名（如www.xxx.com）→ 保存即可
   5. 方案 B：邮件申请安全白名单（彻底解除拦截）
   6. 若基础配置后仍有警告，需发邮件至支付宝技术团队申请高级安全白名单：
   7. 收件邮箱：techservices@alipay.com
   8. 邮件标题：【域名白名单申请】公司名 – PID:XXX
   9. 正文模板（直接复制填写）：
   10. plaintext
   11. 公司名称：XXX有限公司
   12. PID（商户ID/合作伙伴ID）：2088XXXXXXX
   13. 应用AppID：2021XXXXXXX
   14. 申请域名：https://www.xxx.com
   15. 业务场景：网站支付/H5收银台跳转
   16. 联系人：XXX

联系电话：138XXXXXXX

处理时效：工作日 9:00-18:00 受理，1-3 个工作日完成加白

三、支付宝域名报白核心规则（避坑必看）

协议强制：所有场景必须使用HTTPS，HTTP 域名一律无法通过审核；
备案要求：国内域名必须完成ICP 备案，境外域名需提供所有权证明；
格式规范：
不能带端口（如:8080、:443）、路径（如/api）、参数；
不支持localhost、127.0.0.1、内网 IP、私有域名；
生效范围：
小程序预览 / 调试不受白名单限制，体验版、审核版、线上版必须报白支付宝文档中心；
H5 域名报白后，仅对新版小程序生效，旧版不生效支付宝文档中心；
校验要求：H5 域名必须上传官方校验文件至根目录，验证不通过无法添加支付宝文档中心。

四、常见问题与快速自查清单

常见报错 / 解决

1. 报错：请求失败，域名不在白名单内
2. 解决：检查服务器域名是否为 HTTPS、已备案、格式正确，重新提交审核；
3. 报错：H5 页面无法加载，校验失败
4. 解决：确认校验文件已上传根目录、可正常访问，清除浏览器缓存后重试；
5. 支付仍提示 “非官方网页”
6. 解决：提交邮件申请高级安全白名单，核对 PID、AppID、域名信息准确无误。
7. 自查清单（配置后必核对）
8. 域名已备案 + 启用 HTTPS ✅
9. 域名无端口、无路径、纯域名格式 ✅
10. H5 场景校验文件已上传并可访问 ✅
11. 小程序已重新发版（H5 域名修改后）✅

支付场景已提交邮件申请（需彻底解除拦截）✅

五、总结

支付宝域名报白是接入支付宝生态的基础且关键步骤，核心是区分 “服务器域名、H5 域名、支付安全域名” 三大场景，严格遵循 “HTTPS + 备案 + 规范格式 + 所有权验证” 的规则。
小程序开发：优先配置服务器域名（接口）+H5 域名（内嵌页）；
支付业务：基础配置后，务必通过邮件申请彻底解除安全警告；
避坑核心：所有域名必须HTTPS + 备案，H5 场景必传校验文件，小程序改配置必发版。
按照本文流程操作，可快速完成支付宝域名报白，保障业务正常上线、用户支付无阻碍。