CartDNA 应用故障排除
快速解决常见的 CartDNA 应用问题。检查安装失败、支付方式问题、Shopify 结账冲突和计费阻塞。使用本指南查找原因、应用解决方案并使结账重回正轨。
大多数 CartDNA 应用问题来自小的设置错误。根据我们的经验，这涵盖了绝大多数问题。错误的凭据、缺失字段、非活动支付方式和计费缺口都可能阻止结账。本页面帮助您发现问题并自信地修复它。
CartDNA 应用故障排除检查清单
在开启支持工单之前，请先完成这些检查。这个快速审查可以解决许多问题，并帮助您更快地找到确切的故障点。
如何修复 CartDNA 应用安装问题
安装问题是 CartDNA 应用错误的最常见原因。单个错误值可能阻止支付选项加载、授权或在结账时显示。如果应用已安装但未按预期工作，请从这里开始。
错误的 API 密钥或凭据
许多商家复制了错误的密钥、将值放在错误的字段中或混淆测试和生产详细信息。这会导致交易失败、支付方式隐藏或应用配置区域出现连接错误。
要检查的内容
- •API 密钥与正确的支付提供商账户匹配
- •商户 ID、密钥、令牌或端点粘贴到正确字段
- •测试凭据仅在测试模式下使用
- •生产凭据仅在生产模式下使用
- •复制的值中没有空格或缺失字符
最佳操作
- •重新保存设置
- •运行测试结账
- •Review setup guidance at Integration
缺少自定义配置详细信息
某些 CartDNA 应用需要额外的自定义设置才能正常工作。这可能包括商户特定选项、回调详细信息、环境设置或提供商要求的支付方式规则。
常见迹象
- 支付方式加载但在选择后失败
- 订单未完成
- 出现重定向或授权问题
要做什么
- •在应用配置中检查每个必填字段
- •确认提供商特定选项已完成
- •更改后重新测试每个支付流程
测试模式和生产模式冲突
这是一个常见错误。商家有时添加测试凭据然后尝试生产结账。其他人添加生产凭据并仅在沙箱中测试。这种冲突通常会阻止交易或隐藏支付方式。
使用这个简单规则修复它
- 测试凭据 + 测试结账
- 生产凭据 + 生产结账
在公开发布前始终运行成功的测试结账。
支付方式问题
有时 CartDNA 应用配置正确，但支付方式仍不显示或处理。在这些情况下，问题通常出在支付提供商账户，而不是 Shopify 或 CartDNA 应用本身。
支付方式未在提供商处启用
支付方式必须在处理器端处于活动状态，Shopify 才能使用它。如果该方式未启用，即使您的 CartDNA 应用设置看起来正确，客户在结账时也看不到它。
检查这些要点
- •支付方式已在您的 PSP 账户中启用
- •您的提供商已批准您的业务使用该方式
- •该方式支持您的地区、货币和商店类型
Related page: 支付
支付提供商已禁用该方式
提供商有时会因账户审查、入职不完整、合规挑战或风险控制而禁用支付选项。发生这种情况时，CartDNA 应用无法强制该方式工作。
要做什么
- •登录您的支付提供商仪表板
- •检查账户警报和通知
- •如果方式已被停止，请联系提供商
- •重新激活后重新测试
Shopify 结账故障排除
即使 CartDNA 应用配置正确，Shopify 设置也可能阻止支付流程。如果结账失败，接下来检查您的 Shopify 配置。当客户无法看到或使用支付选项时，这些检查尤其重要。
未启用必填结账字段
某些支付方式需要购买者数据，如电子邮件地址或电话号码。如果这些字段在 Shopify 结账时不是必填的，支付流程可能会失败或根本不显示支付选项。
检查这些设置
- •在需要的地方启用电子邮件
- •在需要的地方启用电话号码
- •账单和运输数据收集与提供商要求匹配
启用了手动捕获
当 Shopify 支付设置中激活手动捕获时，某些支付方式无法正常工作。这可能会破坏预期的授权和捕获流程。
操作
- •在 Shopify 中检查您的捕获设置
- •调整后重新测试支付方式
不支持的账单或运输国家
如果您的结账国家与支付方式支持的市场不匹配，该选项可能保持隐藏。国家规则通常同时适用于账单和运输位置。
要检查的内容
- •支持的国家已在 Shopify 中启用
- •Shopify Markets 设置正确
- •支付方式支持所选国家
CartDNA 支付方式已安装但未激活
仅安装不会完成设置。支付方式还必须从 Shopify 端激活。这是一个简单的步骤，但在上线时经常被忽略。
操作
- •打开 Shopify 管理后台
- •转到支付设置
- •确认 CartDNA 支付方式处于活动状态
- •保存更改并测试结账
Shopify 订阅或平台计费问题
如果您的 Shopify 订阅处于非活动状态或 Shopify 计费付款失败，结账和应用行为可能会受到影响。此问题超出正常应用设置范围，因此值得尽早检查。
检查
- •Shopify 订阅状态
- •失败的计费警报
- •影响结账或应用访问的管理消息
支付规则冲突
隐藏和显示规则可能相互冲突。当这种情况发生时，即使应用正常工作，支付方式也可能不会向购买者显示。
要检查的内容
- •支付自定义规则
- •隐藏支付应用的结账逻辑
- •基于市场、国家或购物车的条件
不支持商店货币
并非每种支付方式都支持每种货币。如果不支持您的 Shopify 默认货币，客户在结账时可能看不到该选项。
检查
- •默认商店货币
- •市场货币设置
- •支付方式的货币支持
CartDNA 计费问题
某些应用访问问题与计费或法律接受步骤相关。这些检查很容易被忽略，但在完成之前可能会阻止应用使用。
未接受服务条款和许可协议
如果尚未完成必要的条款、许可协议或入职步骤，您的 CartDNA 应用可能未在完整功能状态下运行。
操作
- •检查待处理的协议请求
- •接受所有必要条款
- •确认入职已完成
逾期的 CartDNA 费用
未付发票可能会影响应用状态。计费缺口可能会停止访问、暂停服务或延迟支持解决，直到账户更新为止。
操作
- •查找逾期费用
- •如有必要，更新付款详细信息
- •付款后确认账户状态
上线前的最佳实践
正确的上线前测试可减少结账问题并保护转化。不要仅依赖配置。在向购买者提供支付选项之前，始终运行真实的端到端测试。
建议步骤
常见问题
为什么我的 CartDNA 支付方式在 Shopify 结账时不显示？
这通常指向以下四个问题之一：非活动支付方式、错误的凭据、国家或货币冲突，或隐藏应用的支付规则。从激活、凭据和结账设置开始。
如何修复 CartDNA 应用凭据错误？
在配置区域再次检查每个 API 密钥、令牌和商户详细信息。确保测试和生产值不混淆。保存更改，然后在匹配模式下运行测试结账。
为什么 CartDNA 在测试模式下工作但在生产模式下失败？
生产模式故障通常是因为未添加生产凭据、提供商未启用支付方式，或 Shopify 结账设置阻止了流程。
我每个问题都必须联系 CartDNA 支持吗？
不必。大多数问题可以通过检查凭据、激活状态、Shopify 字段、计费状态以及测试与生产设置来解决。在完成本页面上的检查后联系支持。
更快修复您的 CartDNA 应用
大多数 CartDNA 应用故障排除问题来自安装、激活或结账设置。使用本指南逐步解决问题、测试流程并为您的客户恢复无摩擦的结账体验。