|
|
| (61 intermediate revisions by the same user not shown) |
| Line 1: |
Line 1: |
| ==Quick Start==
| | [[Quick Start]] |
| ===Demo Video===
| |
| * [https://ftp.wizarpos.com/advanceSDK/paymentapptest.mp4 paymentapptest.mp4]
| |
| ===User Guide===
| |
| * [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.
| |
| * 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 [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==
| |
| ===Protocol===
| |
| Please refer to the protocol which communicate with payment app.
| |
| * [https://ftp.wizarpos.com/advanceSDK/PaymentApp/WIZARPOSPaymentAppIntegrationProtocolV2.0.10.pdf WIZARPOSPaymentAppIntegrationProtocolV2.0.10.pdf]
| |
|
| |
|
| ===Payment Apps===
| | [[Windows Debug Tools]] |
| The two payment apps need install to terminal firstly.
| |
| * [https://ftp.wizarpos.com/advanceSDK/PaymentApp/PayWizard_Demo_V2.0.1_2510161.apk PayWizard_Demo_V2.0.1_2510161.apk]
| |
| * [https://ftp.wizarpos.com/payment/OPC_V1.10.5-global-release.apk OPC_V1.10.5-global-release.apk]
| |
|
| |
|
| === Local Integration ===
| | [[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 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===
| | [[Payment Apps|Payment Apps(Usually installed by WizarPOS)]] |
| 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===
| | [[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 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==
| | [[Internal Integration (POS App Development)|Internal Integration (Develop POS APP and call AIDL)]] |
| * [https://ftp.wizarpos.com/advanceSDK/MDB_Version_4-3.pdf MDB_Version_4-3.pdf]
| |
|
| |
|
| ==FAQ==
| | [[Cloud Mode Integration]] |
| *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]
| | [[Payment App Development]] |
| *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]
| | [[Common Feature Development]] |
| *[https://github.com/SmartPOSSamples/KioskDemo.git Kiosk+Home+Launcher demo]
| | |
| *[https://smartpossdk.gitbook.io/cloudpossdk/faq/other-development/disable-home-key Disable home button]
| | [[Chinese Document]] |
| *[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]]==
| |
