Payment App: Difference between revisions

From wizarPOS
No edit summary
No edit summary
 
(47 intermediate revisions by the same user not shown)
Line 3: Line 3:
* [https://ftp.wizarpos.com/advanceSDK/paymentapptest.mp4 paymentapptest.mp4]
* [https://ftp.wizarpos.com/advanceSDK/paymentapptest.mp4 paymentapptest.mp4]
===User Guide===
===User Guide===
* [https://ftp.wizarpos.com/advanceSDK/PyamentAppUserGuide.pdf PyamentAppUserGuide.pdf]
* [https://ftp.wizarpos.com/payment/PaymentInterfaceAppUserGuide.pdf PaymentInterfaceAppUserGuide.pdf]
===Steps===
===Demonstration steps(Connect terminal to PC)===
* Install Payment Apps, apps can install through by ADB, or push through by TMS.
* Install Payment Apps, apps can install through by ADB, or push through by TMS.
* Set protocal type in Payment app, refer to [https://ftp.wizarpos.com/advanceSDK/PyamentAppUserGuide.pdf PyamentAppUserGuide.pdf]
* Set protocal type in Payment app, refer to PaymentInterfaceAppUserGuide.pdf
* Connect terminal to PC
* Connect terminal to PC
* Start serial port tool in PC
* Start serial port tool in PC
* Send handshake command data through by serial port tool, refer to [https://ftp.wizarpos.com/advanceSDK/test.txt TestData]
* Send handshake command data through by serial port tool, refer to [https://ftp.wizarpos.com/advanceSDK/test.txt TestData]
* Send Transaction command data through by serial port tool, refer to [https://ftp.wizarpos.com/advanceSDK/test.txt TestData]
* Send Transaction command data through by serial port tool, refer to [https://ftp.wizarpos.com/advanceSDK/test.txt TestData]
 
===Debug tools in Windows===
* Serial port tool-- Download from Microsoft Store
* Serial/Socket tool -- [https://drive.google.com/file/d/1zDeboNelN5zhDsjldgXw7fCt5FgEhOw6/view?usp=sharing Payment Serial/Socket debug tool] [https://ftp.wizarpos.com/payment/windowsserial&socketguide.docx Spec of the tool]
==Develop resource==
==Develop resource==
===Protocol===
===Protocol===
Please refer to the protocol which communicate with payment app.
Please refer to the protocol which communicate with payment app.
* [https://ftp.wizarpos.com/advanceSDK/PaymentApp/WIZARPOSPaymentAppIntegrationProtocolV2.0.6.pdf WIZARPOSPaymentAppIntegrationProtocolV2.0.6.pdf]
* [https://ftp.wizarpos.com/advanceSDK/PaymentApp/WIZARPOSPaymentAppIntegrationProtocol2.0.8.pdf WIZARPOSPaymentAppIntegrationProtocol2.0.8.pdf]
===Payment Apps===
===Payment Apps===
The two payment apps need install to terminal firstly.
The two payment apps need install to terminal firstly.
* [https://ftp.wizarpos.com/payment/PayWizard_Demo_V1.0.0_2507091.apk PayWizard_Demo_V1.0.0_2507091.apk]
* [https://ftp.wizarpos.com/payment/PayWizard_Demo_V2.0.0_2508081.apk PayWizard_Demo_V2.0.0_2508081.apk]
* [https://ftp.wizarpos.com/payment/OPC_V1.5.0-global-release.apk PaymentApp_V1.5.0-global-release.apk
* [https://ftp.wizarpos.com/payment/OPC_V1.10.5-global-release.apk OPC_V1.10.5-global-release.apk]
=== Full develop SDK===
 
* [https://ftp.wizarpos.com/advanceSDK/PaymentInterface_20250612.zip PaymentInterface_20250612.zip]
=== Local Integration ===
===AIDL develop SDK===
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.
Applicable for scenarios where application development on a POS terminal is required, involving direct calls to the Payment AIDL Interface. (适用于需要在POS机上开发应用，这种情况下，直接调用Payment AIDL Interface.)
* Reference for data packaging and unpacking of VM：[https://ftp.wizarpos.com/advanceSDK/PaymentApp/Serial&SocketDemo240910.zip Serial&SocketDemo240910.zip]
* [https://ftp.wizarpos.com/advanceSDK/PaymentApp/AIDL_Service_Demo&Guide.zip AIDL_Service_Demo&Guide.zip]
* See also, [https://smartpossdk.gitbook.io/paywizard-open-api/semi-integration/local-integration local-integration]
=== 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通讯。)
===Internal Integration===
* [https://ftp.wizarpos.com/advanceSDK/PaymentApp/PaymentApp_Serialport_Guilde&Demo.zip PaymentApp_Serialport_Guilde&Demo.zip]
It is suitable for developing applications on the terminal. When this application uses the payment function, it only calls the payment AIDL interface provided by the payment application. Other functions of the application are implemented by the application itself.  
* Reference for calling payment AIDL interface：[https://github.com/SmartPOSSamples/PayMentAIDLDemo PayMentAIDLDemo]
* See also, [https://smartpossdk.gitbook.io/paywizard-open-api/semi-integration/internal-integration internal-integration]
 
===Payment App development===
It is suitable for developing payment application on the terminal. This payment application interacts with the bank and provides the AIDL interface of the payment function to the terminal payment OPC call. Please contact sales for guidance from the development team.[https://ftp.wizarpos.com/advanceSDK/PaymentApp/AIDLServiceDemo240910(ProvidedAIDLtoOPC).zip A simple service demo which provided AIDL interface].
 
==Others==
==Others==
* [https://ftp.wizarpos.com/advanceSDK/MDB_Version_4-3.pdf MDB_Version_4-3.pdf]
* [https://ftp.wizarpos.com/advanceSDK/MDB_Version_4-3.pdf MDB_Version_4-3.pdf]
* [https://ftp.wizarpos.com/advanceSDK/支付接口操作文档.pdf 支付接口操作文档.pdf]
 
* [https://ftp.wizarpos.com/advanceSDK/PaymentApp/慧银支付应用集成协议V2.0.6.pdf 慧银支付应用集成协议V2.0.6.pdf]
==FAQ==
*Simple prototype file, generally, configure this file in TMS, [https://ftp.wizarpos.com/payment/opc-v1.7.0-config-simplify-20250814.xml Parameters-Prototype xml file：opc-v1.7.0-config-simplify-20250814.xml]. Package name of the payment app is "com.wizarpos.paywizard.demo"
*Full prototype file, don't use this file, just for a reference, [https://ftp.wizarpos.com/payment/opc-v1.7.0-config-20250814.xml Parameters-Prototype xml file：opc-v1.7.0-config-20250814.xml]
*To configure app paramter, pelase read this "Configure a Parameter File with a Template" chapter of the [https://smartpossdk.gitbook.io/cloudpossdk/faq/tms-wizarview/accept-tms-file-downloads spec], please use prototype file- opc-v1.7.0-config-simplify-20250814.xml, package name which accept the parameter is "com.wizarpos.opc".
*[https://smartpossdk.gitbook.io/cloudpossdk/faq/advance-sdk/learn-kiosk-mode learn-kiosk-mode]
*[https://github.com/SmartPOSSamples/KioskDemo.git Kiosk+Home+Launcher demo]
*[https://smartpossdk.gitbook.io/cloudpossdk/faq/other-development/disable-home-key Disable home button]
*[https://smartpossdk.gitbook.io/cloudpossdk/cloudpos-sdk/cloudpos-sdk-aar SDK AAR]
*[https://ftp.wizarpos.com/sdk/device/java/cloudpossdkV1.7.5.1_javaDoc.zip cloudpossdkV1.7.5.1_javaDoc.zip]
*[https://smartpossdk.gitbook.io/cloudpossdk/faq/usb-serial-port/serial-port-development serial-port-development]
*[https://smartpossdk.gitbook.io/cloudpossdk/faq/other-development/install-pos-applications Install APP]
*[https://smartpossdk.gitbook.io/cloudpossdk/faq/certificate/apply-app-certificates Apply APP Certificate]
*[https://smartpossdk.gitbook.io/cloudpossdk/faq/other-development/app-signing-process Sign APP]
*[https://smartpossdk.gitbook.io/cloudpossdk/faq/tms-wizarview/apply-wizarview-account Apply TMS Account]
*[https://ftp.wizarpos.com/device/TMSManual.pdf TMS Manual]
==[[Chinese Document]]==

Latest revision as of 09:29, 29 September 2025

Quick Start

Demo Video

User Guide

Demonstration steps(Connect terminal to PC)

  • Install Payment Apps, apps can install through by ADB, or push through by TMS.
  • Set protocal type in Payment app, refer to PaymentInterfaceAppUserGuide.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

Debug tools in Windows

Develop resource

Protocol

Please refer to the protocol which communicate with payment app.

Payment Apps

The two payment apps need install to terminal firstly.

Local Integration

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.

Internal Integration

It is suitable for developing applications on the terminal. When this application uses the payment function, it only calls the payment AIDL interface provided by the payment application. Other functions of the application are implemented by the application itself.

Payment App development

It is suitable for developing payment application on the terminal. This payment application interacts with the bank and provides the AIDL interface of the payment function to the terminal payment OPC call. Please contact sales for guidance from the development team.A simple service demo which provided AIDL interface.

Others

FAQ

Chinese Document

Retrieved from "http://sdkwiki.wizarpos.com/index.php?title=Payment_App&oldid=5394"