Payment App: Difference between revisions

From wizarPOS
No edit summary
No edit summary
 
(16 intermediate revisions by the same user not shown)
Line 11: Line 11:
* 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_V2.0.0_2508081.apk PayWizard_Demo_V2.0.0_2508081.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.7.0-global-release.apk PaymentApp_V1.7.0-global-release.apk]
* [https://ftp.wizarpos.com/payment/OPC_V1.10.5-global-release.apk OPC_V1.10.5-global-release.apk]


===AIDL develop SDK===
=== Local Integration ===
Applicable for scenarios where application development on a POS terminal is required, involving direct calls to the Payment AIDL Interface.
* [https://github.com/SmartPOSSamples/PayMentAIDLDemo 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.  
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.  
* Reference for data packaging and unpacking of VM：[https://ftp.wizarpos.com/advanceSDK/PaymentApp/Serial&SocketDemo240910.zip Serial&SocketDemo240910.zip]
* Reference for data packaging and unpacking of VM：[https://ftp.wizarpos.com/advanceSDK/PaymentApp/Serial&SocketDemo240910.zip Serial&SocketDemo240910.zip]
* See also, [https://smartpossdk.gitbook.io/paywizard-open-api/semi-integration/local-integration local-integration]
===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.
* 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==
Line 32: Line 40:


==FAQ==
==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]
*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]
*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]
*[https://smartpossdk.gitbook.io/cloudpossdk/faq/tms-wizarview/accept-tms-file-downloads Configure and accept app parameter]
*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]]==
==[[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"