Reader SDK : Quick Start

Step 3: Take a Cash Payment

Java (Android)

Authorize your mobile app Permalink Get a link to this section

Reader SDK must be authorized to collect payments. To get started quickly, get a mobile authorization code from the Reader SDK settings page of your Reader SDK sample application.

  1. Go to the Reader SDK page in your Square application settings and generate a new mobile authorization code by choosing the Generate Mobile Auth Code button. reader-qr-code-auth@2x

  2. For use in a virtual device, copy the mobile authorization code that is generated.

  3. For use on a physical device, keep the QR code open for Option 2, step 4.

Option 1: Take payment on a virtual device Permalink Get a link to this section

  1. Build and run your application on a virtual device (Android Emulator or iOS Simulator) and grant any device permissions requested. page.

  2. Open the Reader SDK sample application.

  3. Choose Enter Code Manually in the sample application.

  4. Paste the mobile authorization code into the field provided.

  5. Choose the Charge $1.00 button to complete a cash transaction.

  6. View the transaction details in the Square Seller Dashboard.

sampleapp-manual-code-entry

Option 2: Take payment on a physical device Permalink Get a link to this section

  1. Build and deploy the sample application to a physical device. If you run into difficulty deploying the application to a physical device, see Run an app on a connected device for Xcode and Run your app for Android Studio.

  2. Grant any device permissions requested.

  3. Open the Reader SDK sample application.

  4. Choose Scan QR Code in the sample application and grant the application Camera permissions.

  5. Scan the QR code from the Square application settings page.

  6. Choose the Charge $1.00 button to complete a cash transaction.

  7. View the transaction details in the Square Seller Dashboard.

sampleapp-qr-code-entry