Payment App

Quick Start

Demo Video

• paymentapptest.mp4

User Guide

• PyamentAppUserGuide.pdf

Steps

• Install Payment Apps, apps can install through by ADB, or push through by TMS.
• Set protocal type in Payment app, refer to PyamentAppUserGuide.pdf
• Connect terminal to PC
• Start serial port tool in PC
• Send handshake command data through by serial port tool, refer to TestData
• Send Transaction command data through by serial port tool, refer to TestData

Develop resource

Protocol

Please refer to the protocol which communicate with payment app.

• WIZARPOSPaymentAppIntegrationProtocolV2.0.6.pdf

Payment Apps

The two payment apps need install to terminal firstly.

• PayWizard_Demo_V1.0.0_2507221.apk
• PaymentApp_V1.5.0_25072211-global-release.apk

Full develop SDK

• PaymentInterface_20250612.zip

AIDL develop SDK

Applicable for scenarios where application development on a POS terminal is required, involving direct calls to the Payment AIDL Interface. (适用于需要在POS机上开发应用，这种情况下，直接调用Payment AIDL Interface.)

• PayMentAIDLDemo

VM develop reference

Suitable for scenarios where no application development on the POS terminal is needed. Instead, the Vendor Machine communicates directly with the Payment App. In this case, communication between the POS terminal and the Vendor Machine supports serial port, MDB (Multi-Drop Bus), and Socket protocols. (适用于不需要在POS机上开发应用，上位机直接和PaymentInterface通讯。这种情况下，POS机和上位机之间支持串口，MDB，Socket通讯。)

• PaymentApp_Serialport_Guilde&Demo.zip

Others

• MDB_Version_4-3.pdf
• 支付接口操作文档.pdf
• 慧银支付应用集成协议V2.0.6.pdf

FAQ

• 取消预授权应该传递什么参数? 是TransIndexCode吗？

不是， TransIndexCode每个交易都是唯一的，由三方应用自己保证唯一性，包括消费、撤销、预授权、预授权增加，预授权完成等交易。需要做撤销、增加、完成等交易，原交易的TransIndexCode送入OriTransIndexCode，对于其他的原交易数据送了都是Ori数据 TraceNum->OriTraceNum TransID->OriTransId InvoiceNum->OriInvoiceNum RRN->OriRrn

• 预授权的金额，到发起预授权扣款的时间大概是多长时间？

一般是实时的，预授权是冻结，预授权完成是解冻，可以理解为消费交易，实时扣款。 预授权和预授权完成可以不是同时进行的，例如住酒店，今天预授权500元，明天离开酒店预授权完成400元，钱是预授权完成的时候扣的。

• 取消预授权：

撤销Reversal

• 预授权preauth发送请求消息后，等待一定时间后用户未刷卡会返回cancel，如果刷卡会立刻收到应答
• 退款refund，需要刷卡
• 但是退款有的版本是：发送refund的时候，如果订单已经完结，不用刷卡，会立刻成功。如果订单不存在，会等待1分钟后返回超时。
• 撤销，预授权完成不用刷卡
• 用户购物花了两元，我们发现算错了要退1元

这个场景可以用预授权2块，预授权完成1块实现，或者消费2块，消费撤销1块

• 撤销Reversal是不是只能撤销已经刷卡的预授权，因为这时有transID

如果用户未刷卡，这个预授权应如何取消， 可以使用协议数据CTRL: 0xC1 indicate Cancel Request

•  终端交易不允许并发，不过再等待刷卡界面可以接受串口过来交易
•  预授权完成之后不能在追加了，相当于已经完成一笔扣款了，所以要明确预授权完整之前进行预授权增加; 完成之后在想增加扣款，除非重新刷卡，重新发预授权和预授权完成; 或者发一笔刷卡消费。 预授权增加可以发多次，完成只能发一次。
• 结算【settle】，每天指定时间，执行一次吗？是的。
• 测试结算时，不用传金额, 是应该把未结算的交易都自动结算吗？是的，不用传金额。
• 二维码支付，是扫手机上的二维码支付，不会在POS机上显示二维码。主扫，不被扫。
• 币种跟最小单位参考: en zh
• transAmount传入的都是整数字符串，具体金额是多少，要看上面的最小单位，比如单位是2， 那么金额有两个小数点。