拉卡拉API支付接口接入需要测试账号吗？沙箱测试账号申请

浏览量：20 2026-09-11 14:13:53

拉卡拉API支付接口接入需要测试账号吗？沙箱测试账号申请

"拉卡拉API支付接口接入需要测试账号吗？""沙箱测试环境怎么开通？""沙箱测试账号怎么申请？""沙箱环境和生产环境有什么区别？""API对接完整流程是什么？""测试卡号在哪里获取？""沙箱测试收费吗？"对于需要对接拉卡拉API支付接口的开发者和企业IT团队来说，在正式上线前必须先在沙箱测试环境中完成接口对接和功能验证，而沙箱测试账号的申请和使用是第一步。本文将为您全面解答拉卡拉API支付接口接入是否需要测试账号，详细解读拉卡拉开放平台与沙箱环境介绍、沙箱测试账号申请完整流程（注册→认证→创建应用→开通沙箱→获取密钥→开始测试，6步搞定）、沙箱环境vs生产环境8项对比（用途/资金/费率/限额/密钥/功能/数据/上线）、API接入完整流程（从注册到上线6步）、沙箱测试支持的功能和支付方式、测试账号/测试卡号使用说明、沙箱测试常见问题解答，帮助开发者快速开通沙箱环境、顺利完成API对接测试。

核心结论：拉卡拉API支付接口接入需要测试账号，正式上线前必须先在沙箱测试环境中完成接口对接和功能验证；沙箱测试账号免费申请、即时开通、不限测试次数，不需要付费，不需要人工审核（开通沙箱一键完成，企业认证需1-3工作日审核）。沙箱测试账号申请6步流程：①<注册开放平台账号>——访问拉卡拉开放平台官网，手机号注册，设置密码，1-2分钟；②<企业实名认证>——上传营业执照、法人身份证、对公账户，完成企业认证（个人开发者可个人认证），1-3工作日审核；③<创建应用>——进入控制台创建应用，填写应用名称、应用类型、回调地址、应用简介，获取AppID，5分钟；④<开通沙箱环境>——在应用详情中点击"开通沙箱"，一键开通，系统自动分配沙箱测试账号和测试商户号，即时生效，免费；⑤<获取沙箱密钥>——在沙箱管理页面获取沙箱AppID、沙箱商户号、沙箱API密钥、沙箱回调地址，配置到代码中，5分钟；⑥<开始沙箱测试>——使用测试卡号/测试账号发起模拟交易，调试接口，查看测试订单和回调日志，不限测试次数，免费。沙箱环境vs生产环境核心区别：沙箱环境用于接口测试（虚拟资金、全部免费、不限次数、沙箱专属密钥、测试数据隔离），生产环境用于正式收款（真实资金、按正式费率收费、按商户资质限额、生产专属密钥、真实交易数据）；两者密钥独立、数据隔离，沙箱测试通过后申请上线切换到生产环境，沙箱数据不迁移。API接入完整6步流程：注册认证→创建应用+开通沙箱→沙箱对接测试→测试通过+申请上线→获取生产密钥+配置→正式上线+运维监控。沙箱测试支持的功能：支付接口（下单/查询/关闭/退款）、分账接口（分账/查询/回退）、对账接口（交易对账/资金对账）、回调通知（支付回调/退款回调/分账回调）等大部分支付API；支持的支付方式包括扫码支付（微信/支付宝/云闪付模拟）、银行卡支付（测试卡号模拟）、小程序支付、H5支付、APP支付等。测试账号/测试卡号：开通沙箱后系统自动分配沙箱测试商户号和测试账号，文档中提供测试卡号（模拟银行卡）、测试手机号、测试验证码等，无需真实银行卡和真实手机号，测试交易不真实扣款。注意事项：①沙箱环境必须先完成企业实名认证才能开通（个人开发者可个人认证但功能受限）；②沙箱密钥和生产密钥严格分开，不要混用；③沙箱测试通过后必须申请上线，经审核通过后才能切换生产环境；④沙箱环境部分高级功能（如跨境支付、数字人民币）可能需要单独申请开通；⑤沙箱测试不产生真实交易和手续费，放心测试。

一、核心结论（需要测试账号吗）

拉卡拉沙箱测试账号申请流程图（6步搞定）

1.1 一句话回答

是的，拉卡拉API支付接口接入需要测试账号，正式上线前必须先在沙箱测试环境中完成接口对接和功能验证；沙箱测试账号免费申请、即时开通、不限测试次数，开通流程简单（6步搞定），不需要付费，不需要复杂的人工审核。

1.2 为什么需要测试账号

• 接口对接调试：API支付接口涉及下单、签名、回调、退款、分账、对账等多个接口，开发者需要在测试环境中反复调试接口参数、签名算法、回调处理等，确保代码正确。如果直接在生产环境调试，会产生真实交易和手续费，且可能影响真实用户，风险很大。

• 功能验证：需要验证各种支付场景（成功/失败/超时/重复支付/退款/分账等）、各种支付方式（扫码/银行卡/小程序/H5/APP等）、异常处理（网络异常/签名错误/参数错误等），确保系统在各种情况下都能正确处理。这些测试在生产环境无法完成（会产生真实交易）。

• 联调测试：支付系统需要与商户的业务系统（订单系统、会员系统、财务系统等）联调，沙箱环境提供完整的测试环境，支持前后端联调、系统集成测试。

• 安全隔离：沙箱环境与生产环境完全隔离（密钥独立、数据独立、资金独立），测试操作不会影响生产环境的真实交易和数据，安全可靠。

• 行业标准做法：所有主流支付机构（支付宝、微信支付、银联、拉卡拉等）都提供沙箱测试环境，要求开发者先在沙箱测试通过后再申请上线，这是支付行业的标准做法和安全要求。

1.3 沙箱测试账号的核心特点

特点	说明
免费	沙箱测试账号和沙箱环境完全免费，不收取任何费用，测试交易不产生手续费
即时开通	完成企业认证后，在应用详情中一键开通沙箱，系统自动分配测试账号和商户号，即时生效，不需要等待人工审核
不限测试次数	沙箱环境不限测试交易次数、不限测试金额，可反复测试，直到功能验证通过
虚拟资金	沙箱交易使用虚拟资金，不真实扣款，不需要真实银行卡，测试卡号由系统提供
环境隔离	沙箱环境与生产环境完全隔离（密钥独立、数据独立、资金独立），测试不影响生产
完整功能	支持大部分支付API（支付/退款/分账/对账/回调等）和主要支付方式（扫码/银行卡/小程序/H5/APP）
文档齐全	提供完整的API文档、SDK（Java/Python/Go）、测试卡号、示例代码、常见问题，开发者可快速上手
技术支持	沙箱测试期间遇到问题可通过开放平台工单、开发者社区、技术支持热线获取帮助

二、拉卡拉开放平台与沙箱环境介绍

2.1 拉卡拉开放平台

• 定位：拉卡拉开放平台是拉卡拉面向开发者和企业提供的API开放服务平台，汇聚拉卡拉支付、分账、对账、风控等核心能力，通过标准化API接口和多语言SDK，帮助开发者快速接入拉卡拉支付能力。

• 核心能力：①支付能力（扫码支付、银行卡支付、小程序支付、H5支付、APP支付、数字人民币等）；②分账能力（分账通API，支持比例/固定/阶梯分账、多级分账、跨境分账）；③对账能力（交易对账、资金对账、差错处理）；④退款能力（全额退款、部分退款、退款查询）；⑤风控能力（实时风控、反欺诈、反洗钱）；⑥商户管理（商户进件、商户查询、商户变更）。

• 开发者资源：①完整的API文档（接口说明、参数定义、请求示例、响应示例、错误码）；②多语言SDK（Java、Python、Go、PHP、Node.js等）；③沙箱测试环境（免费、不限次数）；④示例代码和Demo；⑤开发者社区和技术支持；⑥更新日志和版本说明。

• 接入方式：①API直连（适合有技术团队的企业，自主开发对接）；②SDK集成（快速接入，减少开发工作量）；③SaaS零代码接入（适合无技术团队的企业，通过配置快速接入）；④M站/P站快速部署（适合移动端网页和PC端网页）。

2.2 沙箱测试环境

• 定义：沙箱测试环境（Sandbox）是拉卡拉开放平台提供的模拟测试环境，与生产环境功能一致但使用虚拟资金和测试数据，供开发者在正式上线前进行接口对接、功能测试和联调验证。

• 环境架构：沙箱环境拥有独立的域名、独立的网关、独立的密钥体系、独立的数据库，与生产环境物理隔离，确保测试操作不会影响生产环境。

• 核心功能：①模拟支付交易（使用测试卡号，不真实扣款）；②模拟回调通知（支付成功/失败回调、退款回调、分账回调）；③模拟退款（全额/部分退款）；④模拟分账（多方分账、分账查询、分账回退）；⑤测试订单管理（查询测试订单、测试订单状态）；⑥回调日志查看（查看回调请求和响应，便于调试）；⑦错误码模拟（可模拟各种错误场景）。

• 使用限制：①必须完成企业实名认证后才能开通（个人开发者可个人认证但功能受限）；②沙箱环境仅用于测试，不得用于真实交易；③沙箱数据不会迁移到生产环境；④部分高级功能（如跨境支付、数字人民币、特殊行业支付）可能需要单独申请开通沙箱权限；⑤沙箱环境可能定期维护或升级，届时可能短暂不可用。

• 与生产环境的关系：沙箱环境是生产环境的"镜像"，功能和接口与生产环境一致，但使用虚拟资金和测试数据。开发者在沙箱环境中测试通过后，申请上线，经审核通过后切换到生产环境，使用生产密钥和真实资金进行正式交易。

2.3 沙箱环境的价值

• 降低开发风险：在沙箱环境中调试接口，不会产生真实交易和手续费，不会影响真实用户，即使代码有bug也不会造成资金损失，大幅降低开发风险。

• 提高开发效率：沙箱环境提供完整的测试工具（测试卡号、回调日志、错误码模拟），开发者可以快速验证各种场景，减少调试时间，提高开发效率。

• 保障上线质量：要求开发者在沙箱环境中完成全面测试（正常流程、异常流程、边界条件），测试通过后才能申请上线，保障上线质量和系统稳定性。

• 节省成本：沙箱环境完全免费，不限测试次数，企业不需要为测试支付任何费用，节省测试成本。

• 安全合规：沙箱环境与生产环境隔离，测试数据不涉及真实用户隐私和资金，符合支付安全和数据合规要求。

三、沙箱测试账号申请流程（6步详解）

3.1 第1步：注册开放平台账号

• 操作：访问拉卡拉开放平台官网（https://open.lakala.com 或通过拉卡拉官网进入开放平台），点击"注册"按钮，使用手机号注册账号，设置登录密码，完成短信验证码验证。

• 所需信息：手机号（用于接收验证码和后续通知）、登录密码（建议设置强密码）、企业名称（预填写，后续认证时完善）、联系人姓名和邮箱。

• 耗时：1-2分钟。

• 注意：①一个手机号只能注册一个开放平台账号；②请使用企业常用手机号注册，避免后续人员变动导致账号无法登录；③注册后请妥善保管账号和密码，建议开启二次验证（如支持）。

3.2 第2步：企业实名认证

• 操作：登录开放平台，进入"账号中心"或"认证中心"，选择"企业认证"，填写企业基本信息，上传认证资料，提交审核。

• 所需资料：①企业营业执照（彩色扫描件或照片，需在有效期内）；②法人身份证正反面（彩色扫描件或照片，需在有效期内）；③对公银行账户信息（开户名、开户行、账号，用于后续结算和验证）；④企业联系人信息（姓名、手机号、邮箱、职位）；⑤部分行业可能需要额外资质（如医疗、教育、金融等特殊行业需提供行业许可证）。

• 认证方式：①对公账户打款验证（拉卡拉向企业对公账户打一笔小额款项，企业输入金额完成验证，最常用）；②法人实名认证（法人人脸识别验证）；③营业执照OCR识别+人工审核。

• 审核时效：1-3个工作日（资料齐全且符合要求的情况下，通常1个工作日内完成）。

• 个人开发者：个人开发者可选择"个人认证"（身份证+人脸识别），但个人认证的账号功能受限（如无法开通部分高级接口、无法使用生产环境正式收款），建议企业用户完成企业认证。

• 注意：①认证资料必须清晰、完整、真实，不得伪造或篡改；②企业名称必须与营业执照一致，后续结算账户开户名必须与企业名称一致；③认证审核期间可先浏览文档和SDK，但无法开通沙箱和生产环境；④如认证被驳回，按驳回原因修改后重新提交。

3.3 第3步：创建应用

• 操作：企业认证通过后，进入开放平台"控制台"，点击"创建应用"，填写应用信息，提交创建。

• 所需信息：①应用名称（如"XX商城支付"、"XX平台分账"，建议与业务相关，便于管理）；②应用类型（如"网页应用"、"移动应用"、"小程序"、"后台系统"等，根据实际接入场景选择）；③应用简介（简要描述应用用途和业务场景，100字以内）；④回调地址（支付结果回调通知的URL，沙箱环境可先填写测试回调地址，如https://test.example.com/callback，生产环境需填写正式回调地址）；⑤应用图标（可选，上传应用Logo）；⑥行业分类（选择应用所属行业，如电商、餐饮、教育、医疗等）。

• 获取AppID：应用创建成功后，系统自动分配唯一的AppID（应用ID），这是应用的唯一标识，后续API调用需要使用。

• 耗时：5分钟。

• 注意：①一个企业账号可以创建多个应用（如不同业务线、不同平台），每个应用有独立的AppID和密钥；②回调地址必须是可公网访问的HTTPS地址（沙箱环境可使用内网穿透工具如ngrok进行本地测试）；③应用创建后可在应用详情中修改基本信息，但AppID不可更改；④如应用涉及特殊行业（如金融、医疗），可能需要额外审核。

3.4 第4步：开通沙箱环境

• 操作：进入应用详情页面，找到"沙箱环境"或"开发设置"模块，点击"开通沙箱"按钮，确认开通。

• 开通方式：一键开通，不需要填写额外信息，不需要人工审核，系统自动处理。

• 系统自动分配：开通成功后，系统自动分配：①沙箱测试商户号（用于沙箱环境的商户标识）；②沙箱测试账号（用于登录沙箱管理后台）；③沙箱AppID（沙箱环境的应用ID，与生产AppID不同）；④沙箱API密钥（用于沙箱环境的接口签名，与生产密钥不同）。

• 生效时间：即时生效，开通后立即可用。

• 费用：完全免费，不收取任何开通费和使用费。

• 注意：①开通沙箱前必须完成企业实名认证（个人认证账号可能无法开通或功能受限）；②每个应用可独立开通沙箱环境，多应用可分别开通；③沙箱环境开通后可在"沙箱管理"页面查看测试账号、商户号、密钥等信息；④如开通失败，检查是否完成企业认证、应用是否创建成功，或联系技术支持。

3.5 第5步：获取沙箱密钥

• 操作：进入应用详情→"沙箱管理"或"沙箱密钥"页面，查看和获取沙箱环境的密钥信息。

• 需要获取的信息：①沙箱AppID（沙箱应用ID）；②沙箱商户号（沙箱测试商户号）；③沙箱API密钥（用于接口签名的密钥，通常是一串随机字符串，需妥善保管）；④沙箱网关地址（沙箱环境的API请求地址，与生产网关不同，如https://sandbox-api.lakala.com）；⑤沙箱回调地址（可在沙箱管理中配置或修改回调通知地址）；⑥测试卡号（沙箱环境提供的模拟银行卡号，用于测试支付）；⑦测试手机号和验证码（用于测试需要手机号验证的场景）。

• 配置到代码：将获取的沙箱AppID、商户号、API密钥、网关地址配置到项目代码中（建议使用配置文件或环境变量管理，不要硬编码在代码中）。

• 耗时：5分钟。

• 注意：①沙箱密钥与生产密钥严格分开，不要混用（用沙箱密钥调用生产接口会失败，反之亦然）；②API密钥是敏感信息，不要泄露给他人，不要提交到代码仓库（如GitHub），建议使用环境变量或加密配置；③如怀疑密钥泄露，可在沙箱管理页面重置密钥（重置后旧密钥立即失效，需更新代码中的配置）；④沙箱网关地址与生产网关地址不同，注意区分，不要调用错误的地址。

3.6 第6步：开始沙箱测试

• 操作：配置好沙箱密钥后，按照API文档编写代码，使用测试卡号发起模拟交易，调试接口，验证功能。

• 测试内容：①支付接口测试（下单、查询、关闭）；②回调通知测试（支付成功回调、支付失败回调、回调验签）；③退款接口测试（全额退款、部分退款、退款查询）；④分账接口测试（分账下单、分账查询、分账回退）；⑤对账接口测试（交易对账下载、资金对账下载）；⑥异常场景测试（参数错误、签名错误、网络超时、重复请求、金额超限等）；⑦各种支付方式测试（扫码、银行卡、小程序、H5、APP）。

• 测试工具：①测试卡号（系统提供的模拟银行卡，支持测试成功/失败/超时等场景）；②回调日志查看（在沙箱管理页面查看回调请求和响应的详细日志，便于调试回调问题）；③测试订单查询（查询测试订单的状态和详细信息）；④错误码查询（API文档中提供完整的错误码列表和解决方案）；⑤SDK示例代码（参考SDK中的示例代码快速上手）。

• 测试次数：不限次数，可反复测试，直到所有功能验证通过。

• 注意：①沙箱测试使用虚拟资金，不真实扣款，不需要真实银行卡，放心测试；②测试过程中遇到问题可查看回调日志、错误码文档，或通过工单/社区/技术支持热线求助；③建议编写完整的测试用例，覆盖正常流程、异常流程、边界条件，确保测试全面；④测试通过后，整理测试报告，准备申请上线。

四、沙箱环境vs生产环境对比

沙箱环境 vs 生产环境对比图（拉卡拉API）

4.1 8项核心对比

对比项	沙箱环境（测试用）	生产环境（正式用）
用途	接口对接调试、功能测试、联调验证，不涉及真实资金和真实用户	正式收款交易，面向真实用户，涉及真实资金和真实交易
资金	虚拟资金，测试金额不真实扣款，无需真实银行卡，使用系统提供的测试卡号	真实资金，真实扣款和到账，需绑定真实结算银行卡，交易资金D0实时到账
费率	全部免费，不产生任何手续费，测试交易不收费	按正式费率收费：信用卡0.6%、扫码0.38%（1000内）、储蓄卡0.5%封顶20元，D0秒到无额外费
限额	不限测试次数，不限交易金额，可反复测试，可模拟大额交易	按商户资质设定限额：电签版单笔5万/单日30万，大POS单笔10万/单日50万，企业商户可申请提额
密钥	沙箱专属AppID、商户号、API密钥、网关地址，与生产环境独立分开	生产环境专属AppID、商户号、API密钥、网关地址，需妥善保管，泄露需立即重置
支持功能	支持大部分支付接口（支付/退款/分账/对账/回调），部分高级功能（跨境/数字人民币）需单独申请	全部功能开放：支付/退款/分账/对账/风控/商户管理/跨境支付/数字人民币等全功能
数据	测试数据独立，与生产数据隔离，测试订单不影响真实业务，沙箱数据不迁移到生产	真实交易数据，永久保存，可查询和导出，用于财务对账、税务申报、数据分析
上线	测试通过后申请上线，切换到生产环境，沙箱环境可继续保留用于后续功能测试	申请审核通过后上线，正式对外提供服务，需确保接口稳定、监控告警完善、7×24小时运维

4.2 密钥和网关地址区分

• 为什么要区分：沙箱环境和生产环境使用完全独立的密钥体系和网关地址，目的是确保测试环境和生产环境隔离，防止测试代码误调用生产接口造成真实交易，也防止生产密钥在测试过程中泄露。

• 如何区分：①AppID不同（沙箱AppID通常以特定前缀标识，如"sandbox_"或单独的编号段，生产AppID是正式编号）；②商户号不同（沙箱测试商户号与生产商户号不同）；③API密钥不同（沙箱密钥和生产密钥是独立的两串密钥）；④网关地址不同（沙箱网关地址通常包含"sandbox"或"test"字样，生产网关是正式地址）。

• 配置建议：①使用配置文件或环境变量管理密钥和网关地址，开发/测试环境使用沙箱配置，生产环境使用生产配置；②通过构建脚本或CI/CD流水线自动切换配置，避免手动修改出错；③代码中不要硬编码密钥和网关地址，便于环境切换和密钥管理；④上线前仔细检查配置，确保使用的是生产密钥和生产网关地址，不要误用沙箱配置。

• 常见错误：①用沙箱密钥调用生产网关（会返回签名错误或商户不存在）；②用生产密钥调用沙箱网关（会返回权限错误）；③代码中硬编码了沙箱地址，上线时忘记修改（导致生产环境调用沙箱接口，交易失败）；④密钥泄露（将密钥提交到公开代码仓库）。

4.3 数据隔离说明

• 完全隔离：沙箱环境和生产环境使用独立的数据库、独立的服务器、独立的网络，数据完全隔离，沙箱中的测试订单、测试商户、测试资金不会出现在生产环境中，反之亦然。

• 沙箱数据不迁移：从沙箱切换到生产环境时，沙箱中的测试数据（测试订单、测试商户、测试配置）不会自动迁移到生产环境，需要在生产环境中重新配置和初始化。

• 生产数据不影响沙箱：生产环境的真实交易数据不会同步到沙箱环境，沙箱环境中只能看到测试数据。

• 沙箱数据保留：沙箱环境的测试数据会保留一定时间（通常3-6个月），便于后续回归测试和问题排查；超过保留期的数据可能被清理，如需长期保存请自行导出。

• 数据安全：沙箱环境中的测试数据不涉及真实用户隐私（使用测试卡号和测试手机号），符合数据安全和隐私保护要求；但仍需注意不要在沙箱环境中输入真实的银行卡号、真实身份证号等敏感信息。

五、API接入完整流程（从注册到上线6步）

拉卡拉API支付接口接入完整流程图（从注册到上线6步）

5.1 完整6步流程总览

步骤	环节	耗时	核心工作
第1步	注册认证	1-3工作日	注册开放平台账号，完成企业实名认证（营业执照+法人身份证+对公账户），审核通过
第2步	创建应用+开通沙箱	10分钟	创建应用获取AppID，一键开通沙箱环境，获取沙箱测试账号、商户号、API密钥、网关地址
第3步	沙箱对接测试	3-10天（视复杂度）	阅读API文档，下载SDK，配置沙箱密钥，使用测试卡号发起模拟交易，调试支付/退款/分账/对账/回调接口，覆盖正常和异常场景
第4步	测试通过+申请上线	1-3工作日	沙箱测试全部通过，整理测试报告，提交上线申请，填写生产环境信息，绑定真实结算卡，签署服务协议，等待审核
第5步	获取生产密钥+配置	1-2天	审核通过后获取生产AppID、商户号、API密钥、生产网关地址，配置生产回调地址，切换代码到生产环境，设置IP白名单，进行生产环境小流量验证
第6步	正式上线+运维监控	持续	正式对外提供支付服务，真实用户交易，D0实时到账，监控接口稳定性和交易成功率，建立告警机制，7×24小时运维，定期对账和财务核对

5.2 各步骤详细说明

第1步：注册认证（1-3工作日）

• 注册开放平台账号（手机号注册，1-2分钟）

• 提交企业认证资料（营业执照、法人身份证、对公账户，30分钟）

• 等待审核（1-3工作日，资料齐全通常1个工作日内通过）

• 认证通过后可创建应用和开通沙箱

第2步：创建应用+开通沙箱（10分钟）

• 创建应用（填写应用名称、类型、回调地址、简介，获取AppID，5分钟）

• 一键开通沙箱环境（即时生效，系统自动分配测试账号和商户号）

• 获取沙箱密钥（AppID、商户号、API密钥、网关地址，配置到代码中，5分钟）

第3步：沙箱对接测试（3-10天，视项目复杂度）

• 阅读API文档和SDK（了解接口规范、签名算法、参数定义）

• 搭建开发环境（引入SDK、配置沙箱密钥、搭建回调服务）

• 开发支付功能（下单、查询、关闭、回调处理）

• 开发退款功能（全额退款、部分退款、退款查询、退款回调）

• 开发分账功能（如需要，分账下单、分账查询、分账回退）

• 开发对账功能（交易对账下载、资金对账、差错处理）

• 全面测试（正常流程、异常流程、边界条件、性能测试）

• 编写测试报告（记录测试用例、测试结果、遗留问题）

第4步：测试通过+申请上线（1-3工作日）

• 确认沙箱测试全部通过（所有功能验证完成，无严重bug）

• 提交上线申请（在开放平台控制台点击"申请上线"，填写上线信息）

• 填写生产环境信息（生产回调地址、生产服务器IP白名单、联系人信息）

• 绑定真实结算银行卡（企业对公账户或法人个人账户，用于交易资金结算）

• 签署服务协议（电子签署拉卡拉支付服务协议，明确费率、结算周期、双方权利义务）

• 等待审核（1-3工作日，拉卡拉审核团队审核应用资质、业务场景、测试情况）

• 审核通过后开通生产环境权限

第5步：获取生产密钥+配置（1-2天）

• 获取生产环境密钥（生产AppID、生产商户号、生产API密钥、生产网关地址）

• 配置生产环境（将生产密钥和网关地址配置到生产服务器，更新回调地址）

• 设置IP白名单（将生产服务器IP加入白名单，提高安全性）

• 代码切换（将代码从沙箱配置切换到生产配置，通过配置文件或环境变量管理）

• 生产环境小流量验证（先进行小额真实交易测试，验证支付、回调、到账全流程正常）

• 确认生产环境一切正常后准备正式上线

第6步：正式上线+运维监控（持续）

• 正式对外提供支付服务（开放支付入口，真实用户开始交易）

• 交易资金D0实时到账（7:00-23:00交易实时到账结算卡，23:00后T+1到账）

• 监控接口稳定性（监控API调用成功率、响应时间、错误率）

• 监控交易成功率（监控支付成功率、回调成功率、退款成功率）

• 建立告警机制（接口异常、交易异常、资金异常时自动告警）

• 7×24小时运维（确保系统稳定运行，异常及时处理）

• 定期对账（每日/每周/每月进行交易对账和资金对账，确保账实相符）

• 财务核对（定期核对交易金额、手续费、到账金额，确保财务准确）

• 持续优化（根据业务发展优化支付流程、提升用户体验、扩展支付方式）

5.3 接入时间预估

• 简单接入（仅扫码支付）：注册认证1-3天 + 沙箱对接2-3天 + 申请上线1-2天 + 生产配置1天 = 约5-9个工作日

• 标准接入（支付+退款+回调+对账）：注册认证1-3天 + 沙箱对接5-7天 + 申请上线1-3天 + 生产配置1-2天 = 约8-15个工作日

• 复杂接入（支付+退款+分账+对账+多平台）：注册认证1-3天 + 沙箱对接7-15天 + 申请上线1-3天 + 生产配置2-3天 = 约11-24个工作日

• 影响因素：项目复杂度、开发团队经验、API文档熟悉程度、测试覆盖度、审核速度等。建议提前规划，预留充足的测试和联调时间。

六、沙箱测试支持的功能和支付方式

6.1 支持的API接口

接口类别	具体接口	说明
支付接口	统一下单、订单查询、订单关闭、交易撤销	支持各种支付方式的下单、查询、关闭、撤销，沙箱环境可模拟支付成功/失败/超时
回调通知	支付结果回调、退款结果回调、分账结果回调	异步通知商户交易结果，沙箱环境提供回调日志查看，便于调试回调验签和处理逻辑
退款接口	退款申请、退款查询、退款撤销	支持全额退款和部分退款，沙箱环境可模拟退款成功/失败，验证退款流程
分账接口	分账下单、分账查询、分账回退、分账方管理	支持多方分账、比例/固定/阶梯分账、多级分账，沙箱环境可测试分账规则和资金拆分
对账接口	交易对账下载、资金对账下载、差错处理	支持下载每日交易对账单和资金对账单，沙箱环境可测试对账文件解析和核对
商户管理	商户进件、商户查询、商户变更、商户状态查询	支持商户入驻和管理，沙箱环境可测试商户进件流程（部分功能可能受限）
风控接口	风险查询、交易风控、黑名单查询	支持实时风控查询，沙箱环境可模拟各种风控场景（通过/拒绝/人工审核）

6.2 支持的支付方式

• 扫码支付：微信扫码、支付宝扫码、云闪付扫码（沙箱环境模拟，使用测试二维码，不真实扣款）

• 银行卡支付：信用卡、储蓄卡（沙箱环境使用系统提供的测试卡号，支持模拟磁条卡/芯片卡/NFC挥卡）

• 小程序支付：微信小程序支付、支付宝小程序支付（沙箱环境可测试小程序支付流程）

• H5支付：移动端网页支付（微信H5、支付宝H5，沙箱环境可测试H5支付跳转和回调）

• APP支付：移动端APP支付（iOS/Android，沙箱环境可测试APP支付SDK集成）

• 电脑网站支付：PC端网页支付（沙箱环境可测试PC端支付流程）

• 人脸支付：刷脸支付（部分机型支持，沙箱环境可模拟）

• 数字人民币：数字人民币支付（需单独申请开通沙箱权限）

6.3 沙箱环境测试场景模拟

• 正常场景：支付成功、退款成功、分账成功、回调成功、对账正常

• 异常场景：支付失败（余额不足、密码错误、卡片过期）、支付超时、支付撤销、退款失败、分账失败、回调失败、网络异常

• 边界场景：最小金额（0.01元）、最大金额（模拟大额）、整数金额、带零头金额、重复下单、重复回调、并发请求

• 错误场景：参数错误（缺少必填参数、参数格式错误）、签名错误（签名算法错误、密钥错误）、权限错误（无接口权限、商户号错误）、限流错误（请求频率超限）

• 风控场景：风控通过、风控拒绝、风控人工审核、风险交易拦截（沙箱环境可通过特定测试卡号或金额触发不同风控结果）

6.4 部分高级功能需单独申请

• 跨境支付：跨境收单、跨境分账、外币结算（需企业具备跨境业务资质，单独申请开通沙箱权限）

• 数字人民币：数字人民币支付、数字人民币硬钱包（需单独申请，目前在试点地区开放）

• 特殊行业支付：医疗、教育、金融、保险等特殊行业的支付接口（需提供行业许可证，单独审核开通）

• 大额支付：超过标准限额的大额支付（需企业申请提额，提供业务证明材料）

• 定制化接口：企业定制化需求的特殊接口（需与拉卡拉技术团队沟通，单独开发和测试）

• 申请方式：在开放平台控制台提交功能开通申请，或联系客户经理/技术支持说明需求，拉卡拉团队评估后开通对应沙箱权限。

七、测试账号/测试卡号使用说明

7.1 沙箱测试账号

• 自动分配：开通沙箱环境后，系统自动分配沙箱测试商户号和测试账号，不需要手动申请。

• 查看位置：登录开放平台→进入应用详情→"沙箱管理"页面，可查看：①沙箱测试商户号；②沙箱测试账号（用于登录沙箱商户后台）；③沙箱测试密码（首次登录后可修改）；④沙箱AppID；⑤沙箱API密钥。

• 测试账号用途：①登录沙箱商户管理后台，查看测试订单、测试交易、测试资金；②配置沙箱环境的回调地址、IP白名单等；③查看沙箱环境的对账文件和报表；④管理沙箱测试分账方。

• 注意：①测试账号和密码妥善保管，不要泄露；②测试账号仅用于沙箱环境，不能用于生产环境；③如忘记密码，可在沙箱管理页面重置；④测试账号的权限与生产商户账号类似，但操作的都是测试数据。

7.2 测试卡号

• 获取方式：在开放平台API文档的"沙箱测试"章节或"测试卡号"页面，提供沙箱环境专用的测试卡号列表。

• 测试卡号类型：①测试成功卡号（使用该卡号支付，模拟支付成功）；②测试失败卡号（使用该卡号支付，模拟支付失败，如余额不足）；③测试超时卡号（使用该卡号支付，模拟支付超时）；④测试风控拒绝卡号（使用该卡号支付，模拟风控拦截）；⑤不同银行测试卡（模拟不同发卡行，如工行、建行、招行等）；⑥信用卡测试卡和储蓄卡测试卡（分别模拟信用卡和储蓄卡支付）。

• 使用方法：在沙箱环境发起支付时，输入测试卡号（不需要真实银行卡），输入任意密码（或文档指定的测试密码），即可模拟对应的支付结果（成功/失败/超时等）。

• 注意：①测试卡号仅在沙箱环境有效，在生产环境使用会失败；②测试卡号不真实扣款，不会产生真实交易；③不同测试卡号对应不同的测试结果，根据测试场景选择合适的测试卡号；④测试卡号可能会定期更新，以文档中最新提供的为准；⑤不要在沙箱环境中输入真实银行卡号（虽然沙箱不会真实扣款，但为了数据安全建议使用测试卡号）。

7.3 测试手机号和验证码

• 测试手机号：文档中提供专用的测试手机号，用于需要手机号验证的场景（如短信验证码、用户注册等）。

• 测试验证码：使用测试手机号时，系统会返回固定的测试验证码（如"123456"），或在沙箱管理页面查看验证码，不需要真实接收短信。

• 使用方法：在需要手机号验证的接口中，输入测试手机号和测试验证码，即可通过验证。

• 注意：①测试手机号仅在沙箱环境有效；②不要使用真实手机号进行沙箱测试（避免收到测试短信）；③测试验证码固定，方便自动化测试。

7.4 测试金额规则

• 无限制：沙箱环境测试金额无限制，可测试0.01元的小额交易，也可测试100万的大额交易（模拟）。

• 特定金额触发特定结果：部分沙箱环境支持通过特定金额触发特定测试结果，例如：①金额尾数为".01"触发支付成功；②金额尾数为".02"触发支付失败；③金额尾数为".03"触发支付超时；④金额尾数为".04"触发风控拒绝。具体规则以API文档为准。

• 分账测试金额：测试分账时，确保分账各方金额之和等于交易金额（扣除手续费后），否则分账会失败。

• 退款测试金额：退款金额不能超过原交易金额，部分退款金额需小于原交易金额。

7.5 回调测试工具

• 回调日志查看：在沙箱管理页面→"回调日志"模块，可查看每笔交易的回调请求详细信息：①回调时间；②回调URL；③回调请求参数（完整的POST参数）；④回调响应状态（成功/失败）；⑤回调响应内容（商户返回的内容）；⑥重试次数（回调失败会自动重试）。

• 手动触发回调：对于测试订单，可在回调日志页面手动触发回调（重新发送回调通知），便于调试回调处理逻辑，不需要重新发起交易。

• 回调验签调试：回调日志中提供签名原文和签名值，便于开发者调试回调验签逻辑，确认验签算法正确。

• 使用建议：①回调处理有问题时，首先查看回调日志，确认回调是否发送、参数是否正确、商户响应是否正常；②如回调失败，查看失败原因（网络超时、商户返回错误、验签失败等），针对性修复；③修复后可手动触发回调重新测试，提高调试效率。

八、沙箱测试常见问题

Q1：沙箱测试账号需要付费吗？测试交易收费吗？

A：完全免费，不需要付费。①<账号免费>——沙箱测试账号和沙箱环境开通完全免费，不收取任何开通费、使用费、服务费。②<测试交易免费>——沙箱环境中的测试交易使用虚拟资金，不真实扣款，不产生任何手续费，测试1万笔和测试1笔都不收费。③<不限次数>——沙箱环境不限测试交易次数、不限测试金额，可反复测试，直到功能验证通过。④<SDK和文档免费>——API文档、多语言SDK、示例代码、测试卡号全部免费提供，开发者可自由下载使用。⑤<技术支持免费>——沙箱测试期间遇到问题，可通过开放平台工单、开发者社区、技术支持热线免费获取帮助。⑥<唯一可能的费用>——如果企业需要拉卡拉技术团队提供定制化的一对一技术支持、现场对接、定制开发等增值服务，可能需要付费，但标准的沙箱测试和技术支持完全免费。⑦<总结>——沙箱测试全程免费，企业不需要为测试支付任何费用，放心使用。

Q2：开通沙箱需要什么条件？个人开发者可以开通吗？

A：开通沙箱的核心条件是完成企业实名认证，个人开发者可以个人认证但功能受限。①<企业用户>——完成企业实名认证（上传营业执照、法人身份证、对公账户，1-3工作日审核通过）后，即可在应用详情中一键开通沙箱环境，功能完整，可测试所有标准支付接口。②<个人开发者>——可选择个人认证（身份证+人脸识别），认证后可开通沙箱环境，但功能受限：①无法开通生产环境（不能正式收款）；②部分高级接口（如分账、大额支付、跨境支付）可能无法使用；③测试限额可能较低。个人开发者适合学习和技术研究，正式商业使用建议注册企业账号完成企业认证。③<开通条件总结>——①注册开放平台账号；②完成实名认证（企业认证或个人认证）；③创建至少一个应用；④在应用详情中点击"开通沙箱"。满足以上条件即可开通，不需要额外申请，不需要人工审核开通（实名认证需要审核）。④<特殊行业>——医疗、教育、金融等特殊行业可能需要额外提供行业许可证才能开通对应接口的沙箱权限，标准支付接口不需要。⑤<总结>——企业用户完成企业认证后即可一键开通沙箱，功能完整；个人开发者可个人认证开通但功能受限，建议商业使用注册企业账号。

Q3：沙箱密钥和生产密钥有什么区别？可以混用吗？

A：沙箱密钥和生产密钥是完全独立的两套密钥，严格分开，不能混用，混用会导致接口调用失败。①<沙箱密钥>——沙箱环境专用，包括沙箱AppID、沙箱商户号、沙箱API密钥、沙箱网关地址，用于沙箱环境的接口调用和签名，只能调用沙箱网关，只能处理测试交易。②<生产密钥>——生产环境专用，包括生产AppID、生产商户号、生产API密钥、生产网关地址，用于生产环境的接口调用和签名，只能调用生产网关，处理真实交易。③<为什么不能混用>——①用沙箱密钥调用生产网关：生产网关验证商户号和密钥时找不到对应沙箱商户，会返回"商户不存在"或"签名错误"；②用生产密钥调用沙箱网关：沙箱网关验证时找不到生产商户的沙箱权限，会返回"权限错误"或"商户未开通沙箱"；③混用会导致交易失败、回调失败、数据混乱，严重时可能导致生产环境异常。④<如何避免混用>——①使用配置文件或环境变量管理密钥，开发/测试环境配置沙箱密钥，生产环境配置生产密钥；②通过CI/CD流水线自动切换配置，避免手动修改；③代码中不要硬编码密钥和网关地址；④上线前仔细检查配置，确认使用的是生产密钥和生产网关；⑤密钥命名时加上环境前缀（如SANDBOX_APP_ID、PROD_APP_ID），便于区分。⑤<密钥重置>——如怀疑沙箱密钥或生产密钥泄露，可分别在对应环境的管理页面重置密钥，重置后旧密钥立即失效，需更新代码配置；沙箱密钥重置不影响生产密钥，反之亦然。⑥<总结>——沙箱密钥和生产密钥严格分开，不能混用，使用配置文件和环境变量管理，上线前仔细检查，避免因密钥混用导致交易失败。

Q4：沙箱测试通过后，怎么切换到生产环境？沙箱数据会迁移吗？

A：沙箱测试通过后，需要提交上线申请，经审核通过后获取生产密钥，切换代码配置到生产环境；沙箱数据不会自动迁移到生产环境，需要在生产环境重新配置。①<上线申请流程>——①确认沙箱测试全部通过（所有功能验证完成，无严重bug）；②在开放平台控制台→应用详情→点击"申请上线"；③填写上线信息（生产回调地址、生产服务器IP白名单、业务场景说明、联系人信息）；④绑定真实结算银行卡（企业对公账户，用于交易资金结算）；⑤签署电子服务协议（明确费率、结算周期、双方权利义务）；⑥提交审核，等待拉卡拉审核团队审核（1-3工作日）；⑦审核通过后，生产环境开通，获取生产密钥。②<切换到生产环境>——①审核通过后，在应用详情→"生产管理"页面获取生产AppID、生产商户号、生产API密钥、生产网关地址；②将生产密钥和网关地址配置到生产服务器（更新配置文件或环境变量）；③设置生产环境IP白名单（将生产服务器IP加入白名单，提高安全性）；④更新生产回调地址（确保回调地址是生产环境的正式地址，且可公网访问）；⑤代码切换（通过配置切换，不需要修改业务代码）；⑥生产环境小流量验证（先进行几笔小额真实交易，验证支付、回调、到账全流程正常）；⑦确认一切正常后正式上线，开放给真实用户。③<沙箱数据不迁移>——沙箱环境的测试数据（测试订单、测试商户、测试分账方、测试配置）不会自动迁移到生产环境，原因：①沙箱和生产是完全隔离的两个环境，数据独立；②测试数据不涉及真实业务，迁移到生产没有意义；③生产环境需要真实的商户信息、结算账户、业务配置，不能使用测试数据。④<生产环境需要重新配置>——①在生产环境中重新配置商户信息（企业信息、结算账户、费率）；②重新配置分账方（如使用分账功能，需要在生产环境中添加真实的分账方信息）；③重新配置回调地址、IP白名单等；④生产环境的商户号与沙箱测试商户号不同，使用新的生产商户号。⑤<沙箱环境保留>——切换到生产环境后，沙箱环境仍然保留，可继续用于后续功能开发、版本迭代、回归测试，不需要关闭；建议保留沙箱环境作为长期测试环境。⑥<总结>——沙箱测试通过后提交上线申请，审核通过后获取生产密钥，切换配置到生产环境，小流量验证后正式上线；沙箱数据不迁移，生产环境需重新配置；沙箱环境可保留用于后续测试。

Q5：沙箱环境接口调用失败怎么办？常见错误有哪些？

A：沙箱环境接口调用失败时，按以下步骤排查：先看错误码和错误信息，再检查请求参数、签名、密钥、网关地址、网络，最后查看文档或联系技术支持。①<排查步骤>——①查看接口返回的错误码和错误信息（拉卡拉API返回统一的错误码格式，包含code和msg）；②根据错误码在API文档的"错误码"章节查找对应原因和解决方案；③检查请求参数（必填参数是否齐全、参数格式是否正确、参数值是否合法）；④检查签名（签名算法是否正确、签名密钥是否正确、签名原文是否包含所有必填参数、编码格式是否正确）；⑤检查密钥和网关地址（是否使用了沙箱密钥和沙箱网关地址，有没有误用生产密钥）；⑥检查网络（服务器是否能访问沙箱网关，是否有防火墙或代理拦截，DNS解析是否正常）；⑦查看回调日志（如回调失败，查看回调日志中的请求和响应）；⑧如仍无法解决，提交工单或联系技术支持，提供请求参数、响应结果、错误码等信息。②<常见错误码>——①<签名错误>（如SIGN_ERROR）：签名算法错误、密钥错误、参数顺序错误、编码错误；解决方案：核对签名算法文档，使用SDK自带的签名方法，检查密钥是否正确。②<参数错误>（如PARAM_ERROR）：缺少必填参数、参数格式错误、参数值超出范围；解决方案：核对API文档的参数说明，确保所有必填参数齐全且格式正确。③<商户不存在>（如MERCHANT_NOT_EXIST）：商户号错误、使用了生产商户号调用沙箱、商户未开通沙箱；解决方案：检查商户号是否为沙箱测试商户号，确认已开通沙箱。④<权限不足>（如NO_PERMISSION）：商户未开通该接口权限、应用未授权该接口；解决方案：在控制台检查接口权限，如需开通提交申请。⑤<订单不存在>（如ORDER_NOT_EXIST）：订单号错误、查询的是其他环境的订单；解决方案：检查订单号是否正确，确认是沙箱环境创建的订单。⑥<金额错误>（如AMOUNT_ERROR）：金额格式错误、分账金额之和不等于交易金额、退款金额超过原交易金额；解决方案：检查金额格式（单位为分，整数），核对分账和退款金额。⑦<回调地址错误>（如CALLBACK_URL_ERROR）：回调地址不可访问、不是HTTPS、域名未备案；解决方案：确保回调地址可公网访问，使用HTTPS协议，域名已备案。⑧<系统繁忙>（如SYSTEM_BUSY）：沙箱环境维护或临时故障；解决方案：稍后重试，或查看开放平台公告。③<调试建议>——①使用SDK提供的示例代码作为基础，减少手写代码出错概率；②开启SDK的调试日志，查看完整的请求和响应内容；③使用Postman或类似工具先手动调用接口验证参数和签名正确，再集成到代码中；④编写单元测试，覆盖各种参数组合和异常场景；⑤遇到问题先查文档和错误码，90%的问题可以通过文档解决，剩下的联系技术支持。④<总结>——接口调用失败时按"错误码→参数→签名→密钥→网络→文档→技术支持"的顺序排查，常见错误包括签名错误、参数错误、商户号错误、权限不足、金额错误等，使用SDK和调试日志可快速定位问题。

Q6：沙箱环境的回调通知收不到怎么办？

A：回调通知收不到时，按以下步骤排查：先看回调日志确认是否发送，再检查回调地址、网络、防火墙、验签，最后确认代码处理逻辑。①<排查步骤>——①登录开放平台→应用详情→沙箱管理→回调日志，查看该笔交易的回调记录：a.如果回调日志中没有记录，说明回调尚未触发或交易未完成，等待交易完成或检查交易状态；b.如果回调日志中有记录但状态为"失败"，查看失败原因（网络超时、连接拒绝、商户返回错误、HTTP状态码非200等）；c.如果回调日志中记录状态为"成功"，说明回调已发送且商户返回成功，问题在商户代码的后续处理逻辑。②<检查回调地址>——①回调地址是否正确（在沙箱管理中配置的回调地址与代码中期望的一致）；②回调地址是否可公网访问（本地开发时使用内网穿透工具如ngrok，确保公网可访问）；③回调地址是否为HTTPS（生产环境要求HTTPS，沙箱环境建议也使用HTTPS）；④回调地址域名是否已备案（国内服务器要求域名备案）；⑤回调地址是否有重定向（回调不支持302重定向，确保地址直接返回响应）。③<检查网络和防火墙>——①服务器防火墙是否开放了回调端口（通常是443/HTTPS或80/HTTP）；②是否有安全组、WAF、CDN拦截了回调请求；③服务器是否能正常响应HTTP请求（用curl或浏览器测试回调地址）；④本地开发时内网穿透工具是否正常运行（ngrok地址是否有效）。④<检查代码处理逻辑>——①回调接口是否正确接收POST请求（拉卡拉回调通常是POST方式，参数为JSON或表单格式）；②是否正确解析回调参数（参数名、数据类型、编码格式）；③回调验签是否正确（验证回调请求的签名，确保是拉卡拉发送的合法回调，防止伪造回调）；④处理回调后是否返回了正确的响应（通常要求返回特定的成功标识，如"success"或特定JSON，返回非成功标识会导致回调重试）；⑤是否有异常或错误导致回调处理中断（查看应用日志）。⑤<回调重试机制>——拉卡拉回调通知如果商户返回失败或超时，会自动重试（通常重试多次，间隔时间递增，如1分钟、5分钟、15分钟、30分钟、1小时等），直到商户返回成功或达到最大重试次数。可在回调日志中查看重试记录。⑥<手动触发回调>——在回调日志页面，可对测试订单手动触发回调（重新发送回调通知），便于调试，不需要重新发起交易。⑦<总结>——回调收不到时先查回调日志确认状态，再检查回调地址（可公网访问/HTTPS/无重定向）、网络防火墙、代码处理逻辑（接收/解析/验签/返回成功响应），利用回调日志和手动触发功能快速调试，本地开发使用内网穿透工具。

九、总结

拉卡拉API支付接口接入需要测试账号吗？沙箱测试账号申请，核心要点总结如下：

项目	核心内容
是否需要测试账号	需要，正式上线前必须先在沙箱测试环境完成接口对接和功能验证；沙箱测试账号免费申请、即时开通、不限测试次数
沙箱账号申请6步	①注册开放平台账号（1-2分钟）；②企业实名认证（1-3工作日，营业执照+法人身份证+对公账户）；③创建应用（5分钟，获取AppID）；④开通沙箱环境（一键开通，即时生效，免费，系统自动分配测试账号和商户号）；⑤获取沙箱密钥（AppID/商户号/API密钥/网关地址，配置到代码）；⑥开始沙箱测试（使用测试卡号，不限次数，免费）
沙箱vs生产环境	沙箱：虚拟资金、全部免费、不限次数、沙箱专属密钥、测试数据隔离、支持大部分接口；生产：真实资金、按正式费率收费、按商户资质限额、生产专属密钥、真实交易数据、全部功能开放；两者密钥独立、数据隔离，沙箱测试通过后申请上线切换生产，沙箱数据不迁移
API接入完整6步	①注册认证（1-3工作日）；②创建应用+开通沙箱（10分钟）；③沙箱对接测试（3-10天，视复杂度）；④测试通过+申请上线（1-3工作日审核）；⑤获取生产密钥+配置（1-2天，小流量验证）；⑥正式上线+运维监控（持续，监控+告警+对账）
沙箱支持的功能	支付接口（下单/查询/关闭/撤销）、回调通知（支付/退款/分账回调）、退款接口（全额/部分退款）、分账接口（多方分账/多级分账）、对账接口（交易对账/资金对账）、商户管理、风控接口；支持扫码/银行卡/小程序/H5/APP/PC网站等支付方式；可模拟正常/异常/边界/错误/风控场景
测试账号/卡号	开通沙箱后系统自动分配测试商户号和测试账号（在沙箱管理页面查看）；文档提供测试卡号（成功/失败/超时/风控拒绝等不同场景）、测试手机号、测试验证码；测试金额无限制，特定金额可触发特定结果；回调日志可查看回调详情并手动触发回调
沙箱核心特点	免费、即时开通、不限测试次数、虚拟资金、环境隔离、完整功能、文档齐全、技术支持；部分高级功能（跨境/数字人民币/特殊行业）需单独申请开通
常见问题	沙箱完全免费不收费；企业认证后可一键开通（个人开发者功能受限）；沙箱密钥和生产密钥严格分开不能混用；沙箱数据不迁移到生产需重新配置；接口失败按错误码→参数→签名→密钥→网络顺序排查；回调收不到先查回调日志再检查地址/网络/代码

总结来说，拉卡拉API支付接口接入需要测试账号，正式上线前必须先在沙箱测试环境完成接口对接和功能验证；沙箱测试账号免费申请、即时开通、不限测试次数，开通流程简单（6步搞定）。沙箱测试账号申请6步流程：①注册开放平台账号（手机号注册，1-2分钟）；②企业实名认证（营业执照+法人身份证+对公账户，1-3工作日审核，个人开发者可个人认证但功能受限）；③创建应用（填写应用信息，获取AppID，5分钟）；④开通沙箱环境（一键开通，即时生效，免费，系统自动分配测试账号和商户号）；⑤获取沙箱密钥（AppID/商户号/API密钥/网关地址，配置到代码，5分钟）；⑥开始沙箱测试（使用测试卡号发起模拟交易，调试接口，不限次数，免费）。沙箱环境vs生产环境：沙箱用于测试（虚拟资金、全部免费、不限次数、沙箱专属密钥、测试数据隔离、支持大部分接口），生产用于正式收款（真实资金、按正式费率收费、按商户资质限额、生产专属密钥、真实交易数据、全部功能开放）；两者密钥独立、数据隔离，沙箱测试通过后申请上线切换生产环境，沙箱数据不迁移。API接入完整6步流程：注册认证→创建应用+开通沙箱→沙箱对接测试→测试通过+申请上线→获取生产密钥+配置→正式上线+运维监控，简单接入约5-9工作日，标准接入约8-15工作日，复杂接入约11-24工作日。沙箱支持的功能：支付/退款/分账/对账/回调/商户管理/风控等大部分API，支持扫码/银行卡/小程序/H5/APP等支付方式，可模拟正常/异常/边界/错误/风控场景；部分高级功能（跨境支付、数字人民币、特殊行业）需单独申请开通。测试账号/卡号：开通沙箱后系统自动分配测试商户号和测试账号，文档提供测试卡号（不同场景）、测试手机号、测试验证码，测试金额无限制，回调日志可查看详情并手动触发回调。注意事项：沙箱密钥和生产密钥严格分开不能混用（使用配置文件和环境变量管理）；沙箱数据不迁移到生产，生产环境需重新配置；接口失败按错误码→参数→签名→密钥→网络顺序排查；回调收不到先查回调日志再检查地址/网络/代码；沙箱环境完全免费，放心测试。先在沙箱充分测试，再上线生产，是保障支付系统稳定的最佳实践！