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_2507101.apk
• PaymentApp_V1.5.0_202507151-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.)

• AIDLDemo.zip

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