Testing / Sandbox
Learn how to validate your integration using the sandbox environment and testing tools.
Physical device required
Tap to Pay cannot be tested on an emulator. The SDK performs device integrity checks and will fail to initialize on emulators, rooted devices, or devices with unlocked bootloaders; see Supported Devices for the full hardware requirements. Sandbox mode still requires a physical, NFC-capable device; only the funds movement is simulated.
Enable Sandbox Mode
To start testing your integration without processing real payments, you must initialize the SDK against the sandbox environment. This ensures that all transactions are routed to the sandbox environment and no real money is moved.
// Sandbox is the default (isProduction = false)
Accept.initialize(context = applicationContext)Test PIN Entry
To test the PIN entry flow in the sandbox environment, initiate a transaction with a high amount. Amounts above the contactless cardholder verification limit require a PIN, so the on-glass PIN entry screen will appear.
Amount Format
Remember that the SDK typically accepts amounts in the smallest currency unit (integers).
To test 10.05, you would pass 1005 as the amount.
Test with Tapaya Accept Testing Tool
Availability
Testing tool is right now available only for early adopters.
To test NFC payments without using physical cards, use the Tapaya Accept Testing Tool. This is an HCE (Host Card Emulation) Android app that simulates a contactless card.
- Install the Tool: Download and install the "Tapaya Accept Testing Tool" on a secondary Android device with NFC.
- Configure Card: Open the app and select a test card profile (e.g., Visa, Mastercard).
- Perform Transaction: Initiate a payment in your app and tap the testing device against the back of your terminal device.