Take a cash payment using the Reader SDK. The Reader SDK must be authorized to collect payments.
Reader SDK: Quickstart

Take a Cash Payment

Java (Android)

The Reader SDK must be authorized to collect payments. To get started quickly, get a mobile authorization code for your Reader SDK sample application.

  1. In the Square Developer Dashboard, choose the Reader SDK sample application.

  2. In the left pane, choose Reader SDK, and then choose the Generate Mobile Auth Code button.

    A graphic showing the Generate Mobile Auth Code window, which includes a scannable QR code and text authorization code.

  3. For use on a virtual device, copy the mobile authorization code that is generated.

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

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

  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.

    A graphic showing the three mobile application pages created by the Reader SDK for authorizing the mobile device and taking a payment.

  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.

A graphic showing the three mobile application pages created by the Reader SDK for authorizing the mobile device and taking a payment, with the second page showing an authorization QR code.

Did you know?

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

If you need more assistance, contact Developer Support or ask for help in the Developer Forums.