集成指南
💡 提示：请按照以下清单操作，确保您与 PayKKa 进行了完整的支付接入。
设置您的沙箱环境
创建沙箱账户
- 访问 Sandbox 登录页面
- 按照提示完成帐号登录或注册
完成实名认证和商户入网
- 点击 KYC 的 实名认证 ，填写内容并提交，无需审核可进行下一步 新增商户。
- 进入商户列表页面，点击 新增商户
- 联系对接人员快速审核并开通需要的支付方式
- 点击右上角 头像 -> 个人资料 -> 安全设置 -> 支付密码 (可用于退款校验，请妥善保管）
配置交易密钥
- 点击右上角 头像 -> 设置 -> 权限与安全 -> 交易密钥
- 点击 设置 按钮，点击 新增交易密钥 (会要求输入支付密码)，生成一对新的公私钥对
🔑 交易密钥
- 用于开放平台 API 调用身份和安全认证
- 请妥善保管私钥，防止泄露; PayKKa 不会持久化您的私钥
- 同时最多支持 2 对密钥对，若有需要可手动进行轮换以保证交易安全
🔒 PayKKa 公钥
- 用于开放平台 API 响应和 webhook 请求的安全认证
- 需妥善保管，防止泄露
集成接入
基础准备
- 构建您的应用，根据业务需要接入对应的支付产品
- 确保您接入后可以处理具体细节场景，以便支付交互流程和数据一致性
测试场景
建议核对场景包括:
- 错误或拒绝处理
- 3DS 认证流程
- 本地钱包展示和跳转处理
- 通知 webhook 接收处理和响应
- 退款和争议处理
- 对账单和报表生成
交易验证
发起前请先提供您的出口 IP 地址，作为 IP 白名单
沙箱 API 地址
https://sandbox.aq.paykka.com签名计算
按照 API 认证 中的认证流程对请求和响应进行相应处理。
API 对接
按照 API 参考 中的 API 文档对接所需的接口，并根据响应内容进行处理。
测试卡
# Visa
4242424242424242
# Mastercard
5555555555554444
# Discover
6011111111111117
# Diners Club
3056930009020004
# JCB
3566002020360505
# 3D 卡
4000000000003220
# 3D 卡拒绝
4000008400001629
# 资金不足拒付
4000000000009995上线准备
发起前请先提供您的出口 IP 地址，作为 IP 白名单
上线检查清单
- 完成各项测试验证
- 在生产环境完成支付功能开通
- 设置正确的支付密码
- 配置正确的交易密钥
生产环境准备
根据您的企业注册地，选择对应的 API 地址和账户注册地址
API 地址
- 欧洲地区：
https://pub.eu.paykka.com - 亚太地区：
https://pub.aq.paykka.com