---
title: 连接 Shippo 进行配送
description: 添加 Shippo API 密钥、确认连接并安全断开 Shippo。
---

当您希望 Runner 使用您的 Shippo 账户进行配送和履行时，连接 Shippo。该连接使用 Shippo 提供的 API 密钥。

## 开始前

**入口路径：** **项目 → 应用 → 商店应用 → Shippo**

您需要：

- Shippo 账户和当前的 Shippo API 密钥；
- 权限将该账户连接到 Runner 工作区；以及
- 意识到断开 Shippo 会删除其密钥并为工作区中的所有项目禁用它。

不要将 API 密钥粘贴到聊天或文档中。

## Shippo 控制和结果

| 控制 | 为什么有用 | 接下来会发生什么 |
| --- | --- | --- |
| **连接** | 打开 Shippo 设置。 | Runner 要求输入 **Shippo API 密钥**。 |
| **Shippo API 密钥** | 标识您的 Shippo 账户。 | Runner 检查密钥格式，当值无效时显示错误。 |
| 眼睛图标 | 让您检查值以查找输入错误。 | 在隐藏和可见文本之间切换字段。在共享屏幕前再次隐藏。 |
| 对话框**连接** | 提交密钥。 | 成功时，Runner 关闭对话框、清除字段并将卡更改为已连接。 |
| **取消**或关闭 | 不提交而离开设置。 | Runner 清除从对话框输入的密钥。 |
| 删除或**断开连接** | 开始删除。 | Runner 打开**断开 Shippo？**，显示工作区范围的影响。 |
| 确认**断开连接** | 删除保存的连接。 | Runner 删除 API 密钥并为所有工作区项目禁用 Shippo。 |

## 连接 Shippo

1. 打开**项目 → 应用**。
2. 找到 **Shippo** 并选择**连接**。
3. 从您打算使用的 Shippo 账户复制 API 密钥。
4. 将其粘贴到 **Shippo API 密钥**。
5. 如果 Runner 报告密钥无效，请返回 Shippo 并重新复制，而不是凭猜测编辑密钥。
6. 在对话框中选择**连接**。
7. 等待成功消息并确认卡显示其已连接的断开连接控制。
8. 使用安全测试数据验证配送工作流，然后再依赖它处理客户订单。

## 断开连接或替换密钥

选择卡的断开连接控制并阅读**断开 Shippo？**。仅在可以接受删除密钥并为工作区中的每个项目禁用 Shippo 时才确认。

要使用不同的密钥，请断开当前集成、确认卡不再连接，然后使用替换密钥完成连接工作流。

## 如果 Shippo 无法连接

- **API 密钥无效**表示该值与接受的 Shippo 密钥格式不匹配。
- **无法连接 Shippo** 表示 Runner 未完成提供商连接。保持密钥私密，确认它在 Shippo 中是最新的，然后从卡重试。
- 如果对话框关闭但卡未连接，请在再次提交前刷新应用。
- 如果断开连接失败，假设现有密钥仍然活跃。
- 已连接的卡不能证明费率、标签、承运商或特定发货有效。使用安全测试数据单独验证这些操作。

## 相关指南

- [连接、管理和重新连接应用](./connect-manage-reconnect)
- [连接 4PX 履行](./4px-fulfillment)
- [排查应用连接问题](./troubleshooting)