Reader SDK : Quick Start

Step 3: Authorize Reader SDK and Take a Cash Payment

Reader SDK must be authorized to collect payments. To get started quickly, click "Generate Mobile Auth Code" on the Reader SDK settings page of your Reader SDK Example application.

Java (Android)

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

sampleapp-manual-code-entry

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

  2. Go to the Reader SDK page in your Square application settings and generate a new mobile authorization code by clicking "Generate Mobile Auth Code".

  3. Copy the mobile authorization code string from the Square application settings page.

  4. Open the Reader SDK sample app.

  5. Tap "Enter Code Manually" in the sample app.

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

  7. Tap the "Charge $1.00" button to complete a cash transaction.

  8. View the transaction details in Square Dashboard.

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

sampleapp-qr-code-entry

  1. Build and deploy the sample app to a physical device. If you run into difficulty deploying the app 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. Go to the Reader SDK page in your Square application settings and generate a new mobile authorization code by clicking "Generate Mobile Auth Code".

  4. Open the Reader SDK sample app.

  5. Tap "Scan QR Code" in the sample app and grant the app Camera permissions.

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

  7. Tap the "Charge $1.00" button to complete a cash transaction.

  8. View the transaction details in Square Dashboard.

Did you know?

You can also request a mobile authorization codes programmatically through the Mobile Authorization API.