# QA Checklist (/in-store/getting-started/checklist)



Before releasing your application, run through this Quality Assurance (QA) checklist. It covers functional testing, error handling, and user experience scenarios to minimize issues in the field. Tick each check as you verify it.

<ChecklistProgress />

## 1. Functional Testing [#1-functional-testing]

### Transaction Flows [#transaction-flows]

<ChecklistItem id="TF-1" code="TF-1" title="Successful Payment">
  Verify a standard approved transaction using amount 

  `1.01`

   (code 

  `00`

  ) in the 

  [sandbox environment](./testing)

  .
</ChecklistItem>

<ChecklistItem id="TF-2" code="TF-2" title="Card Authentication Rejected">
  Simulate a rejected transaction using amount 

  `1.07`

   (code 

  `06`

  ) and ensure the app handles it gracefully without crashing.
</ChecklistItem>

<ChecklistItem id="TF-3" code="TF-3" title="Expired Card">
  Simulate an expired card using amount 

  `6.05`

   (code 

  `54`

  ) and check the user message.
</ChecklistItem>

<ChecklistItem id="TF-4" code="TF-4" title="Incorrect PIN">
  Simulate a wrong PIN entry using amount 

  `6.06`

   (code 

  `55`

  ) and check the user message.
</ChecklistItem>

<ChecklistItem id="TF-5" code="TF-5" title="PIN Tries Exceeded">
  Simulate the PIN retry limit using amount 

  `8.06`

   (code 

  `75`

  ) and ensure your app treats it as a terminal failure.
</ChecklistItem>

<ChecklistItem id="TF-6" code="TF-6" title="Cancelled Transaction">
  Initiate a payment and cancel it from the SDK UI (back button or close). Ensure your app returns to the previous screen correctly.
</ChecklistItem>

<ChecklistItem id="TF-7" code="TF-7" title="Receipt Generation">
  Verify that transaction data (Auth Code, TID, Date) is correctly captured and printed/emailed on receipts.
</ChecklistItem>

### Hardware Interactions [#hardware-interactions]

<ChecklistItem id="HI-1" code="HI-1" title="NFC Read">
  Test with physical cards (Visa, Mastercard) and digital wallets (Apple Pay, Google Pay).
</ChecklistItem>

<ChecklistItem id="HI-2" code="HI-2" title="Interrupted Read">
  Remove the card immediately after tapping but before the "beep". Ensure the SDK prompts to tap again or fails gracefully.
</ChecklistItem>

<ChecklistItem id="HI-3" code="HI-3" title="Network Loss">
  Turn off internet/Wi-Fi during a transaction. Verify that the app reports a connection error and doesn't hang.
</ChecklistItem>

## 2. Onboarding & Configuration [#2-onboarding--configuration]

### Merchant Setup [#merchant-setup]

<ChecklistItem id="MS-1" code="MS-1" title="New User Onboarding">
  Run through the full onboarding flow with a fresh account.
</ChecklistItem>

<ChecklistItem id="MS-2" code="MS-2" title="Status Check">
  Verify that 

  `Accept.merchant.onboardingStatus()`

   returns 

  `RequiresAction`

   for a pending merchant and 

  `ReadyForPayments`

   for an approved one.
</ChecklistItem>

## 3. Security & Compliance [#3-security--compliance]

### Device Integrity [#device-integrity]

<ChecklistItem id="DI-1" code="DI-1" title="Root Detection">
  If you have a rooted test device, verify that the SDK refuses to initialize.
</ChecklistItem>

<ChecklistItem id="DI-2" code="DI-2" title="Permissions">
  Revoke permissions (Camera, Location) and attempt to start the SDK. Ensure your app prompts the user to grant them.
</ChecklistItem>

### Data Handling [#data-handling]

<ChecklistItem id="DH-1" code="DH-1" title="Token Management">
  Verify that the SDK token from 

  `POST /merchant/auth/login`

   is fetched from your backend for each session and never hardcoded.
</ChecklistItem>

<ChecklistItem id="DH-2" code="DH-2" title="No Sensitive Data">
  Ensure your app logs 

  **do not**

   print full card numbers or raw track data.
</ChecklistItem>

## 4. Edge Cases [#4-edge-cases]

<ChecklistItem id="EC-1" code="EC-1" title="App Backgrounding">
  Minimize the app during a transaction and restore it. The transaction should either resume or fail safely.
</ChecklistItem>

<ChecklistItem id="EC-2" code="EC-2" title="Incoming Call">
  Call the test device during a payment. The SDK should handle the interruption (usually by pausing or failing).
</ChecklistItem>

<ChecklistItem id="EC-3" code="EC-3" title="Low Battery">
  Test behavior when the device is in "Power Saver" mode (some NFC chips degrade in performance).
</ChecklistItem>

## 5. NFC Tag Sessions (Optional) [#5-nfc-tag-sessions-optional]

Only if your app reads or writes [NFC tags](../integration/nfc_tags) with `com.tapaya:accept-nfc`. Run these on each kind of device you ship to: phones with NFC, and Sunmi P-series terminals with `com.tapaya:accept-nfc-sunmi`.

<ChecklistItem id="NT-1" code="NT-1" title="Support Check">
  Verify that 

  `isSupported()`

   returns 

  `true`

   on every device you ship to and 

  `false`

   on a device without NFC, and that 

  `openSession()`

   fails with 

  `NFC_DISABLED`

   on a phone with NFC switched off.
</ChecklistItem>

<ChecklistItem id="NT-2" code="NT-2" title="Read and Write">
  Tap an NTAG or Ultralight tag, check the session reports the right UID, then 

  `writePage`

   and read the page back with 

  `readPages`

  .
</ChecklistItem>

<ChecklistItem id="NT-3" code="NT-3" title="Wrong Key">
  On MIFARE Classic, authenticate with a wrong key and confirm 

  `AUTH_FAILED`

  , then succeed with the right one.
</ChecklistItem>

<ChecklistItem id="NT-4" code="NT-4" title="Cancel the Tap Wait">
  Cancel 

  `openSession()`

   while it waits for a tap and open a new session straight away.
</ChecklistItem>

<ChecklistItem id="NT-5" code="NT-5" title="Payment Takes Over">
  Start a payment during a session. The session ends as 

  `PAYMENT`

   and the payment goes through.
</ChecklistItem>

<ChecklistItem id="NT-6" code="NT-6" title="Tag Removed">
  Remove the tag during a session and confirm it ends as 

  `CARD_REMOVED`

  .
</ChecklistItem>

<ChecklistItem id="NT-7" code="NT-7" title="NFC Switched Off">
  On a phone, turn NFC off and confirm 

  `openSession()`

   fails with 

  `NFC_DISABLED`

  .
</ChecklistItem>

<ChecklistItem id="NT-8" code="NT-8" title="App Backgrounded">
  On a phone, send the app to the background during a session and confirm it ends as 

  `ACTIVITY_PAUSED`

  .
</ChecklistItem>

## 6. Production Readiness [#6-production-readiness]

<ChecklistItem id="PR-1" code="PR-1" title="Environment Switch">
  **CRITICAL:**

   Ensure 

  `isProduction = true`

   is set for the production build.
</ChecklistItem>

<ChecklistItem id="PR-2" code="PR-2" title="Production Tokens">
  Verify that the backend is pointing to the production Tapaya API endpoints.
</ChecklistItem>

<ChecklistItem id="PR-3" code="PR-3" title="Version Check">
  Ensure you are using the latest stable version of the Tapaya Accept SDK.
</ChecklistItem>

<ChecklistProgress />

<Callout title="Sign-off" type="tip">
  Go through the list on your final release candidate, on the devices you will ship to. Use **Reset** to start a clean run, since ticks from earlier test rounds stay saved in this browser.
</Callout>
