• 新平台

开始集成之前,请先确认以下事项,并进行测试账号的自助申请。

Checklist

1. PCI DSS合规

在开始集成前,请首先确认贵司的PCI DSS的合规情况,这将影响到您可以接入的集成方式。

什么是PCI DSS?
PCI DSS全称为 Payment Card Industry Data Security Standards,是由多个卡组联合制定的关于银行卡数据使用规范。其对卡数据的传输、存储、处理等有着明确的要求。具体可以参考:https://www.pcisecuritystandards.org/pci_security/

当商户使用不同方式处理卡信息时,对商户会有不同的要求。对于在线交易而言最为常见的有以下3种模式:

  1. E-commerce website (third party)

如商户在自己的网页中提供第三方的iframe或者将用户跳转到第三方支付服务商。

  1. E-commerce plug-in

如商户使用第三方建站平台(shopify,shoplazza等),通过平台上提供的支付插件(plug-in)进行接入。

  1. E-commerce website

如商户直接处理明文卡信息的电商网站。即用完整的卡号,有效期,cvv进行支付处理。

针对以上不同场景,PCI DSS要求用户提供不同的SAQ(自评表),其中E-commerce website (third party)和E-commerce plug-in使用SAQ-A;而E-commerce website使用SAQ-D。

此外应用SAQ-D的商户还需要提供第三方的审核报告。

即:

支付场景 PCI自评表 示例
E-commerce website (third party)
E-commerce plug-in
SAQ-A https://www.pcisecuritystandards.org/documents/PCI-DSS-v3_2_1-SAQ-A.pdf
E-commerce website SAQ-D https://www.pcisecuritystandards.org/documents/PCI-DSS-v3_2_1-SAQ-D_Merchant.pdf

2. 注册测试账号-新平台

2.1 自助注册测试账号

https://www.checkout.com/get-test-account-2022
image.png
image.png
image.png请在提交申请后在便可以在邮箱收到确认邮件。发件人:
Okta noreply@okta.com

image.png

在浏览器中打开激活邮件:
image.png
选择并设置安全问题(请务必妥善保存,避免遗忘)
image.png

设置密码,要求至少8个字符,一个大写字母,一个小写字母,一个数字:

image.png当满足条件时,activate account按钮会高亮,点击完成账号创建:
image.png
激活成功,可以开始登录使用:

image.png

登录页面,具体后台操作请与负责贵司的客户经理联系:
image.png

创建&管理密钥
点击Developers->Keys,点击右上角的“create a new key”开始创建密钥。
密钥种类分为API Key和Access Key,本身长期有效,通常仅需要使用API Key便可以完成开发和上线。
image.png

创建公钥,选择类型为“Publishable API key”,输入密钥名称(Key description可选),点击“Create key”发起创建:
image.png
创建成功:
image.png
image.png
务必在这个页面复制并保存密钥:Publishable API key。关闭页面后将无法再次获取明文信息。

创建私钥,选择类型“Secret API Key”,选择范围“Payments”,输入密钥名称(Key description可选),点击“Create key”发起创建:
image.png
创建成功:
image.png
务必在这一页面复制并保存密钥:Secret API Key,关闭页面后将无法再次获取明文信息。
创建完毕的密钥会展示在页面中:
image.png
产生测试数据
可以通过dashboard内建功能一键模拟多条测试数据,便于进行测试:

image.png

创建前,账号下无交易记录:

image.png
创建后:
image.png

创建&管理用户

账号所有人(Owner)可以创建新用户,并根据业务需要自定义用户组权限。

2.2 使用Checkout.com后台系统Dashboard

Dashboard的主要业务功能可以分为8个部分:
Home, Payments, Sub-merchants, DIsputes, Reports, Settlements, Invoices, Analytics, Developers, Risk

此外还有2部分配置功能:
Team Permissions, Notifications
image.png

业务功能

  1. Home:整体业务表现的汇总

image.png

  1. Payments:交易查询&操作(capture,void等)

image.png
image.png

  1. Disputes:查看当前发生的拒付状态&拒付相关操作(提交抗辩材料/接受拒付等)

image.pngimage.png

  1. Reports:报告下载(payments/disputes/retrievals)

image.png
image.png

  1. Settlements:查看清算状态,以及下载清算文件明细

准备工作 - 图29
准备工作 - 图30

  1. Invoices:月账单下载

image.png
image.png

  1. Analytics:内建数据分析功能

image.png
8. Developers:开发者工具
image.png
image.png

  1. Risk:风控相关

image.png

配置功能

  1. Team Permissions:创建新用户,配置新的角色

image.png
准备工作 - 图38
准备工作 - 图39
3. Notifications:配置异步通知
image.png

Team Permissions配置规则

在Team Permissions中新增角色的逻辑是将不同功能模块下的子权限进行组合,当前系统内划分如下:

| 功能模块

| 子权限

| 使用场景&注意事项

| 权限类别

| | —- | —- | —- | —- | | Home

| View homepage, KPIs and Analytics section

| 查看整体业务数据,如支付金额、退款金额、拒付数据、成功率等。

| Read

| | Payment

| View Payment Detail

| 查看一笔交易详情

| Read

| | | View and search for payments

| 查看所有交易并对单笔交易查询

| Read

| | | Void payments

| 操作权限。对一笔未请款的交易发起撤销void

| Write

| | | Capture payments

| 操作权限。对一笔未请款的交易发起请款capture

| Write

| | | Refund payments

| 操作权限。对一笔已经情况的交易发起refund

| Write

| | Fraud management

| Delince high-risk payments

| 当使用了风控产品Prism后,可以添加交易至黑名单。

| Write

| | Sub-entities

| View list of own sub-entities only

| MP场景下查看子商户信息

| Read

| | Disputes

| View unanswered and all disputes lists

| 查看所有拒付交易

| Read

| | | Accept disputes and submit evidence

| 操作权限。对一笔拒付提交抗辩材料,或者接受拒付

| Write

| | Reports

| View and generate payment reports

| 数据相关。查看并下载payment,dispute和retrieval报告

| Read

| | Settlements

| View and search for settlements

| 资金相关。查看并查询结算

| Read

| | | View settlements details and download the transaction breakdown report

| 资金相关。查看结算详情并下载对应报告明细

| Read

| | | View bank account details settlements made to

| 资金相关。查看收款银行信息

| Read

| | Invoices | View and download monthly fees invocies | 账单相关。查看并下载月账单。 | Read | | Developers

| View the list of keys

| 查看所有的密钥

| Read

| | | Create new keys | 密钥权限,可能影响生产。
创建新的密钥 | Write | | | View, create, edit or delete new keys | 密钥权限,可能影响生产。
查看,创建,编辑或删除密钥。 | Write

| | User Management

| View the list of users on the account

| 查看账户上配置的用户信息

| Read

| | | Create, edit, delete users on the account

| 操作权限。创建/修改/删除账户上配置的用户信息

| Write

| | | Create, edit and delete custom roles

| 操作权限。创建/修改/删除账户上配置的角色

| Write

| | Notifications

| View the list of workflow notifications

| 查看配置的异步通知

| Read

| | | Create, edit and delete workflow notifications

| 操作权限。创建/修改/删除异步通知配置

| Write

| | | View secret keys | 查看异步通知中配置的密钥。 | Read |

**

3. 注册测试账号-老平台

3.1 自助注册测试账号

商户可以在Checkout.com的官网自助注册测试账号,注册链接:
URL 请咨询负责贵司的工程师。

注意事项:

  1. 请输入英文或汉语拼音,避免输入简体汉字等,以避免注册失败
  2. 使用贵公司的邮箱,或非日常使用邮箱注册(如网易yeah.net )

image.png

image.png
在注册成功后,您的邮箱将收到一封注册成功的通知邮件
image.png

使用其中的用户名/密码即可登录Checkout.com的后台系统Hub获取测试密钥等,开始后续集成步骤。

3.2 使用Checkout.com后台系统Hub

使用上述邮件中的用户名/密码,即可登录Checkout.com后台系统:
URL 请咨询负责贵司的工程师。

首次登录时需要进行密码重置:
image.png
密码重置页面:
image.png
重置后再次登录即可:
和集成开发相关的在Settings页面下
image.png
在Settings->Channel下,既可以找到测试环境公私钥,及Webhook异步通知配置的入口。(关于异步通知将在后文中具体描述)
image.png