|
|
| (8 intermediate revisions by the same user not shown) |
| Line 1: |
Line 1: |
| ==[[Quick Start]]==
| | [[Quick Start]] |
| ==[[Windows Debug Tools]]==
| |
| ==[[Core Protocol]]==
| |
| ==[[Payment Apps]]==
| |
| ==Develop resource==
| |
| ===Protocol===
| |
| Please refer to the protocol which communicate with payment app.
| |
| * [https://ftp.wizarpos.com/payment/WIZARPOSPaymentAppIntegrationProtocolV2.2.2.6.pdf WIZARPOSPaymentAppIntegrationProtocolV2.2.2.6.pdf]
| |
|
| |
|
| ===Payment Apps===
| | [[Windows Debug Tools]] |
| The two payment apps need install to terminal firstly.
| |
| * [https://ftp.wizarpos.com/payment/PayWizard_Demo_V2.2.5_2602121.apk Payment Emulator]
| |
| * [https://ftp.wizarpos.com/payment/OPC_V2.4.0-global-release.apk PAYwizard2.4.0.apk]
| |
|
| |
|
| === Local Integration(No need develop POS APP) ===
| | [[Core Protocol|Core Protocol(Important Payment Communication Protocols)]] |
| Suitable for scenarios where no application development on the POS terminal is needed. Instead, the Vendor Machine communicates directly with the OPC. 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(develop POS APP)===
| | [[Payment Apps|Payment Apps(Usually installed by WizarPOS)]] |
| It is suitable for developing normal applications on the terminal. It can call the AIDL interface provided by the PAYwizard application to do different transaction. It communicate with the Vendor Machine.
| |
| * Reference for calling PAYwizard AIDL interface：[https://github.com/SmartPOSSamples/PayMentAIDLDemo APP project:PayMentAIDLDemo-guide to call PAYwizard aidl interface]
| |
| * [https://ftp.wizarpos.com/payment/PayMentAidlDemo_release_V1.0.6_20260114.apk Download APK]
| |
| * See also, [https://smartpossdk.gitbook.io/paywizard-open-api/semi-integration/internal-integration internal-integration]
| |
|
| |
|
| ===Payment App development===
| | [[Local Integration (External Device)|Local Integration (The VM and the POS communicate directly through serial port or network, etc.)]] |
| 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 PAYwizard to call.
| |
|
| |
|
| [https://github.com/SmartPOSSamples/AidlServiceDemo A simple service demo which provided AIDL interface]. | | [[Internal Integration (POS App Development)|Internal Integration (Develop POS APP and call AIDL)]] |
|
| |
|
| [https://ftp.wizarpos.com/techsupport/ticket/WIZARPOSPaymentAppAIDLManualV1.0.5.pdf WIZARPOSPaymentAppAIDLManualV1.0.5.pdf, if running above service demo, the bind package name should be com.wizarpos.aidlservicedemo]. | | [[Cloud Mode Integration]] |
|
| |
|
| [https://ftp.wizarpos.com/payment/OPCPaymentIntegrationScheme2025.pdf OPCPaymentIntegrationScheme2025.pdf, description of the scheme]. | | [[Payment App Development]] |
|
| |
|
| ==Others==
| | [[Common Feature Development]] |
| ===Cloud Mode===
| |
| * Integrate flow, please refer to https://smartpossdk.gitbook.io/paywizard-open-api/cloud-api/quick-start-cloud-api
| |
| * [https://github.com/SmartPOSSamples/PaywizardCloudAPIDemo.git A simple android demo which access the cloud API to do transaction. Actually, users can develop any http project to access Cloud API, the demo is only a reference].
| |
| * [https://github.com/SmartPOSSamples/PaywizardDemo A simple java demo which access the cloud API to do transaction. Actually, users can develop any http project to access Cloud API, the demo is only a reference].
| |
|
| |
|
| ===Best practice for payment in D22(D3)/Q3(Q2)===
| | [[Chinese Document]] |
| * Install [https://ftp.wizarpos.com/payment/AccessoryAgentHostService-master-release-v1.0.30-r20251208115422-q1_platform.apk the new accessory agent] on D22(D3)/Q3(Q2)
| |
| * Install initconnectionmode on D22/Q3, configure master and slave. This step is usually pre-initialized at the factory and does not require further configuration by the customer.
| |
| * Install PAYwizard app on D22/Q3
| |
| * Set protocal of PAYwizard to DEFAULT on D22, and set the payment package name to com.wizarpos.opc
| |
| * Set protocal of PAYwizard to USB ACCESSORY on Q3, and set the payment package name to com.wizarpos.paywizard.demo
| |
| ===MDB Internal Communication Protocol===
| |
| * [https://ftp.wizarpos.com/advanceSDK/MDB_Version_4-3.pdf MDB_Version_4-3.pdf]
| |
| | |
| ==FAQ==
| |
| *Simple prototype file, generally, configure this file in TMS, [https://ftp.wizarpos.com/payment/opc-v2.2.5-config-simple-20251217.xml Simple parameters-Prototype xml file]. 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-v2.4.0-config-all-20260130.xml Full parameters-Prototype xml file]
| |
| *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], 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]]==
| |
