# 集成指南

> 💡 **提示**：请按照以下清单操作，确保您与 PayKKa 进行了完整的支付接入。


## 设置您的沙箱环境

### 创建沙箱账户

- 访问 [Sandbox 登录页面](https://portal-sandbox.paykka.com/login)
- 按照提示完成帐号登录或注册


### 完成实名认证和商户入网

- 点击 **KYC** 的 **实名认证** ，填写内容并提交，无需审核可进行下一步 **新增商户**。
- 进入商户列表页面，点击 **新增商户**
- 联系对接人员快速审核并开通需要的支付方式
- 点击右上角 **头像** -> **个人资料** -> **安全设置** -> [**支付密码**](https://portal-sandbox.paykka.com/user/payment-password?type=set) (可用于**退款**校验，请妥善保管）


### 配置交易密钥

> 💡 **提示**：对于平台型客户接入无需配置，须联系PayKKa相关人员了解详情


- 点击右上角 **头像** -> **设置** -> **权限与安全** -> [**交易密钥**](https://portal-sandbox.paykka.com/setting/transaction-password)
- 点击 **设置** 按钮，点击 **新增交易密钥** (会要求输入支付密码)，生成一对新的公私钥对


🔑 **交易密钥**

- 用于开放平台 API 调用身份和安全认证
- 请妥善保管私钥，防止泄露; PayKKa 不会持久化您的私钥
- 同时最多支持 2 对密钥对，若有需要可手动进行轮换以保证交易安全


🔒 **PayKKa 公钥**

- 用于开放平台 API 响应和 webhook 请求的安全认证
- 需妥善保管，防止泄露


## 集成接入

### 基础准备

- 构建您的应用，根据业务需要接入对应的支付产品
- 确保您接入后可以处理具体细节场景，以便支付交互流程和数据一致性


### 测试场景

**建议核对场景包括**:

- 错误或拒绝处理
- 3DS 认证流程
- 本地钱包展示和跳转处理
- 通知 webhook 接收处理和响应
- 退款和争议处理
- 对账单和报表生成


### 交易验证

发起前请先提供您的出口 IP 地址，作为 IP 白名单

#### 沙箱 API 地址


```bash
https://openapi-sandbox.paykka.com
```

#### 签名计算

按照 [API 认证](/zh-hans/payments/apis/introduction/api-certification) 中的认证流程对请求和响应进行相应处理。

#### API 对接

按照 [API 参考](/zh-hans/payments/apis/payments/openapi) 中的 API 文档对接所需的接口，并根据响应内容进行处理。

#### 测试卡


```plaintext
# Visa
4242424242424242

# Mastercard
5555555555554444

# Discover
6011111111111117

# Diners Club
3056930009020004

# JCB
3566002020360505

# 3D 卡
4000000000003220

# 3D 卡拒绝
4000008400001629

# 资金不足拒付
4000000000009995
```

## 上线准备

发起前请先提供您的出口 IP 地址，作为 IP 白名单

### 上线检查清单

- 完成各项测试验证
- 在生产环境完成支付功能开通
- 设置正确的支付密码
- 配置正确的交易密钥


### 生产环境准备

> 根据您的企业注册地，选择对应的 API 地址和账户注册地址


#### API 地址

- **亚太地区**：`https://openapi.paykka.com`
- **欧洲地区**：`https://openapi.eu.paykka.com`


#### 账户注册地址

- **亚太地区**：[https://portal.paykka.com](https://portal.paykka.com)
- **欧洲地区**：[https://mps.eu.paykka.com](https://mps.eu.paykka.com)