业务用语

本章节主要规范项目内使用的业务用语名称，以及相关的说明。

一）业务术语

收单方/收单机构（Acquirer）

与商户签订收单协议并为其提供支付及资金清算能力的服务机构。本项目中即指SnapPay。

商户（Merchant）

具备经营证照并允许开展各类商业服务的主体。

本系统中的商户必须要求登记1个真实经营地址的实体门店

代理商（Agent）

与SnapPay签订合作协议，为其拓展线上线下商户，并代为销售各类收单产品的经营实体。

支付业务（Payment Business）
发起支付交易的不同业务场景，如：POS收银、立招二维码、发票账单推送、学校缴费等。

支付通道（Payment Channel）

收单机构通过对接不同的支付服务商（如：腾讯、阿里、银联、VISA）的系统，向商户提供完整支付能力，这类服务渠道称为“支付通道”。

收单机构可借助多样化的支付通道，打造各具特色的“收单产品”，向商户提供服务。

根据支付通道的技术规范，开发对应的收银插件程序/服务，实现相关的支付功能。此外，支付通道提供的业务能力也不尽相同。如：某些通道支持余额查询，某些支持预授权交易...

每个支付通道必须且只能固定1种结算币种

支付方式（Payment Mode）
支付行为所采用的方式，一般按银行卡组织、支付受理平台归属的支付产品进行区分：

银行卡类：银联卡、VISA、MasterCard 等；

扫码类：微信支付、支付宝等

收单产品（Acquiring Product）

收单方将自己的支付服务能力进行包装，选定支付通道并制订服务内容及销售价格，用于市场销售。商户签约收单产品后即开通支付相关的服务。

支付场景类型（Payment Scene Type）
包括：

线下支付（In-Store Payment）：在商户线下门店发生的支付行为，常见的POS线下刷卡、扫码支付的主/被扫；

线上支付（Online Payment）：通过传统网站页面发起的支付行为，主要在PC端的浏览器中完成；或者通过移动端APP发起的支付行为，如：公众号支付、H5支付、小程序支付等；

对接的支付通道，根据以上类型提供的技术解决方案及服务手续费率等均有差异。

终端类型（Terminal Type）

为商户提供支付的终端类型包括：

1）WPOS

2）立招二维码

3）扫码设备（扫码枪或扫码盒子）

商户所在时区（Merchant Timezone）

根据商户注册签约时确定的时区信息（一般是商户注册地所使用的时区），系统内关于此商户的经营活动数据均以此时区为准。时区采用国际标准的表达方法，如：America/Toronto

交易类型（Transaction Type）

交易类型参考传统POS的规范罗列如下：

名称	说明
消费 purchase transaction	指特约商户在出售商品或提供服务时，通过POS终端完成消费者用卡付款的过程。
消费撤销 purchase cancellation transaction	指特约商户由于各种原因对已经通过POS联机完成的成功消费交易，于当日当批主动发起取消的过程。
退货 return transaction	指特约商户因商品退回或服务取消，将已扣款项退还持卡人原扣款账户的过程；包括全额和部分金额退货。退货主要是次日或更长时间，在通道方支持的时间范围内进行的行为。
余额查询 balance inquiry transaction	持卡人通过ATM等终端或其它受理渠道进行相关账户余额查询的过程。
预授权 pre-authorization transaction	指特约商户通过POS终端，就持卡人预计支付金额向发卡机构索取付款承诺的过程
预授权撤销 pre-authcancellation transaction	指特约商户在取得预授权后的有效期内，通过POS终端或手工方式通知发卡机构取消付款承诺的过程。
预授权完成 pre-authorization completion transaction	指特约商户对已取得预授权的交易，在预授权金额或超出预授权金额一定比例的范围内，通过POS终端将交易信息实时提交发卡机构完成持卡人付款的交易。
预授权完成撤销 pre-authorization completion cancellation transaction	指特约商户由于各种原因对已经成功的预授权完成交易，于当日当批主动发起的取消交易。

交易子类型（Transaction Sub Type）
对交易类型的扩展描述，如：Apple Pay，Huawei Pay，免密免签等

交易状态（Transaction Status）
包括：交易进行中，交易完成，交易关闭三个状态。

支付操作方式（Payment Operation Method）
常见的方式有：刷卡、挥卡、插卡、扫码（主扫 or 被扫）

货币类型（Currency Type）
指该笔交易使用的结算货币类型，符合 ISO4217标准的三位字母代码。

结算币种（Settling Currency），为商户或代理商结算资金时使用的货币类型，使用标准三位字母代码。
系统默认为加币：CAD，可选美元USD。

货币单位（Currency Unit）

货币符号（Currency Symbol）

二）支付业务服务（Payment Business Service）

支付业务（Payment Business）
发起支付交易的不同业务服务或场景，如：POS收银、立招二维码、发票账单推送、学校缴费等。

2.1 标识类

订单号（Order No）
支付业务系统生成的订单编号，保证在各自业务系统内的唯一性。

2.2 金额类

商品原价（Sales Original Price）

商品销售的原始金额。

总税费（Total Tax）

根据国家地区的税收政策计算的税金。加拿大地区主要有 GST、PST或HST几种。

商品订单金额（Sales Order Amount）

商品销售下单的金额，包含税费部分的总额。

收单方商户优惠（Discount By Merchant On Acquirer ）
商户通过收单方的系统发布营销活动（优惠券、代金券、礼品卡）等，用户支付时享受减免的部分。
此种优惠属预留扩展，在本项目中不会涉及。后续根据SnapPay业务发展情况引入。

小费（Tip）

顾客向商户收银员额外支付的服务小费。

商户订单金额（Merchant Order Amount）

商户发起支付的订单总金额，包括商品含税金额及小费。

顾客交易手续费（Customer Transaction Fee）
交易手续费由顾客承担部分的金额。

三）收单服务（Acquire Service）

3.1 标识类

商户订单号（Merchant Order No）
收银应用或第三方业务系统生成的订单编号，应保证在对应系统内唯一性。

交易号（Transaction No）
收单系统中的交易流水标识，交易体系内全局唯一。在交易全生命周期内的数据交换，均以此标识作为关键要素传递。

通道交易号（Payment Channel Transaction No）
交易过程中，在第三方支付通道的系统中生成的交易唯一标识。（注：非银行卡类通道一般是指直接对接的服务方，银行卡类通道=交易参考号）

交易凭证号（Transaction Voucher No）
仅限银行卡类交易，在终端发起交易时创建的识别号，以通道返回的为准。

交易批次号（Transaction Batch No）
仅限银行卡类交易，在终端发起交易时创建的识别号，以通道返回的为准。

交易参考号（Transaction Reference No）
仅限银行卡类交易，交易过程中由支付通道方返回的唯一标识号。

收单产品商户签约合同号（Acquiring Product Merchant Contract No）

商户与收单方签订的收单产品服务合同的编号

收单产品代理合同号（Acquiring Product Agency Contract No）

代理商与收单方签订的代理收单产品的合同编号

3.2 金额类

交易金额（Transaction Amount）
商户发起支付请求，进入交易过程中，向支付通道上送的付款总金额。包括：支付业务系统上送的“商户订单金额”与“顾客支付手续费”之和。

支付通道商户优惠（Discount By Merchant On Payment Channel）
商户在支付通道的服务提供方（微信、支付宝等）的系统发布营销活动（优惠券、代金券、满减、单品优惠），用户支付时享受的金额减免。此部分费用不会结算到商户账上。
注：在通道方的支付控件环节中进行减免

支付通道优惠（Discount By Payment Channel）
一般为支付通道提供方（微信、支付宝等）给用户提供的优惠，在交易过程中直接减免，如：鼓励金、随机立减、现金红包等营销活动。

交易手续费（Transaction Fee）
依据收单产品签约费率计算的手续费金额。一般来说，商户选择收单产品签约时就已确定收费比率，如：1.5%；

除手续费费率外，还可能有手续费封顶值；

商户签约费率后一般不会变化，若需要变更，则需要重新换签产品；

手续费算法：采用四舍五入的方式，保留两位小数；

手续费收取方，一般来说均由商户承担，部分情况下也可以由顾客承担：

商户交易手续费（Merchant Transaction Fee）：交易手续费由商户承担部分的金额

顾客交易手续费（Customer Transaction Fee）：交易手续费由顾客承担部分的金额

1）此策略必须在签订收单产品时明确，不允许随时更改，因为可能导致资金结算及代理分润的问题。
2）手续费由收单方收取，均不会结算给商户。

顾客实付金额（Customer Paid Amount）
交易过程中从顾客资金账户中实际支付的金额。

商户应收金额（Merchant Receivable Amount）
交易完成后，收单方应结算到商户资金账户的金额。

金额类要素之间，存在以下的关系：

商户侧
    商户应收金额 = 商户订单金额 - 支付通道商户优惠 - 商户交易手续费

顾客侧
    顾客实付金额 = 商户订单金额 + 交易手续费(顾客) – 商户优惠总额 - 支付通道顾客优惠

3.3 时间类

如无特殊约定，本项目内的时间均为多伦多时间(America/Toronto)

交易开始时间（Transaction Start Time）
指终端发起交易的时刻。
终端插件模式下，收银SDK如果主动上送了创建时间，则以该时间为准；否则均以交易后台收到交易创建请求的时刻为准。

交易完成时间（Transaction Finish Time）
一般指在支付通道完成交易的时间，通过交易请求的响应报文中对应字段提供。
如果通道的支付技术规范中，返回值有交易时间，则必须以此上送交易后台；不传值时默认交易数据更新的时间为交易完成时间。

交易关闭时间（Transaction Closed Time）
交易状态关闭的时间。一般来说，通道方返回“交易失败”结果的时候，报文中会有明确的时间信息，插件应将此值上送。无法获得此时间的情况下，服务器则记录为收到“交易关闭”请求的时刻。

3.4 商户及终端

商户号（Merchant No）
SnapPay为已签约商户分配的唯一标识。

门店编号（Store No）
SnapPay为商户门店分配的唯一标识。

终端号（Terminal No）
SnapPay为签约商户的终端分配的唯一标识。

所属代理商编号（Agent No）
商户归属的代理商标识

设备编号（Device EN）
接入系统的收银设备的虚拟序列号。如：WPOS的EN号

硬件序列号（Device SN）
收银终端设备的硬件识别号。

3.5 用户信息类

付款账号（Payment User Account ID）
交易过程中用于支付的账户ID，不同支付方式下有所不同。

银行卡类：银联、VISA、Master等，即为银行卡号。

微信支付：用户的OpenID（相对于当前发起支付的公众号APP）

支付宝：用户的UserID

付款用户账户名（Payment User Account Name）
付款用户的真实名称或识别名称。

银行卡类型（Bankcard Type）

借记类（Debit Card）：包括借记卡、预付卡

贷记类（Credit Card）：包括贷记卡、准贷记卡

收款账号（Seller Account ID）
交易过程中商户用于收款的账户ID或银行卡号。

3.6 其他要素

交易位置（Transaction Location）

经纬度坐标：交易创建时刻，终端所在位置的经纬度坐标。（部署在AWS均使用Google坐标系）

省（州或地区）/市：根据地图API将坐标转换为省/市信息。

四）设备管理服务（Device Management Service）

安全处理器（Secure Processor）

简称SP，WPOS终端上的安全处理芯片，可用于生成、保存敏感数据

应用（Application）

安装在WPOS设备上的Android应用程序或服务

五）常用缩写表

下表是常用英文的缩写，可根据需要选择使用。

英文名称	缩写	英文名称	缩写
acquire	acq	transaction	trans
business	biz	application	app
payment	pay	information	info
description	desc	management	man
upper_limit	ul