Payment App: Difference between revisions
No edit summary |
|||
| (35 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/ | * [https://ftp.wizarpos.com/payment/PaymentInterfaceAppUserGuide.pdf PaymentInterfaceAppUserGuide.pdf] | ||
=== | ===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 | * 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/ | * [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/ | * [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 | * [https://ftp.wizarpos.com/payment/OPC_V1.10.5-global-release.apk OPC_V1.10.5-global-release.apk] | ||
=== 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. | |||
* 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== | ||
* [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] | ||
==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]. 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
- Serial port tool-- Download from Microsoft Store
- Serial/Socket tool -- Payment Serial/Socket debug tool Spec of the tool
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.
- Reference for data packaging and unpacking of VM：Serial&SocketDemo240910.zip
- See also, 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：PayMentAIDLDemo
- See also, 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.A simple service demo which provided AIDL interface.
Others
FAQ
- Simple prototype file, generally, configure this file in TMS, 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, 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 spec, please use prototype file- opc-v1.7.0-config-simplify-20250814.xml, package name which accept the parameter is "com.wizarpos.opc".
- learn-kiosk-mode
- Kiosk+Home+Launcher demo
- Disable home button
- SDK AAR
- cloudpossdkV1.7.5.1_javaDoc.zip
- serial-port-development
- Install APP
- Apply APP Certificate
- Sign APP
- Apply TMS Account
- TMS Manual