Applies to: Reader SDK - Android | Reader SDK - iOS | Customers API
Learn how to collect card information and save a customer's card on file.
The Mobile Payments SDK has launched as the successor of the Reader SDK. To take in-person payments on Square hardware, you should migrate from the Reader SDK to the Mobile Payments SDK.
Use the Reader SDK card-on-file workflow to create a customer card for an existing Customer object. The card-on-file workflow is a sequence of screens used by customers to specify that they want to save their card information for future purchases.
Always ask customers for permission before saving their card information. For example, include a checkbox in your purchase flow that customers can select to specify that they want to save their card information for future purchases.
Linking cards on file without obtaining customer permission can result in your application being disabled without notice.
CUSTOMERS_WRITE permission to save a card on file and PAYMENTS_WRITE permission to process payments with the saved card. Cards on file are automatically updated on a monthly basis to confirm that they are still valid and can be charged.Customer object using the Customers API. To create your first Customer object, see Customers API.The card-on-file workflow begins with an asynchronous call to Square servers, which can be slow depending on network conditions.
You should display a spinner or loading indicator before starting the card-on-file workflow and clear it when you receive the result (success or failure) so users know that work is being performed in the background.
Use the CustomerCardManager class to create a new customer card manager to securely collect card information. Customer card information is stored on Square servers, not on the device running the Reader SDK, so you need to implement a callback to handle the response from Square.
import com.squareup.sdk.reader.ReaderSdk;
import com.squareup.sdk.reader.crm.CustomerCardManager;
import com.squareup.sdk.reader.core.CallbackReference;
CustomerCardManager customerCardManager =
ReaderSdk.customerCardManager();
...
CallbackReference storeCardCallbackRef = customerCardManager.addStoreCardActivityCallback(result -> {
hideLoadingIndicatorOnYourActivity();
if (result.isSuccess()) {
showStoreCardSuccessDialog(result.getSuccessValue());
} else {
showErrorDialog(result.getError());
}
});Use the customer card manager to start the StoreCard activity and link the card to an existing customer ID.
showLoadingIndicatorOnYourActivity(); customerCardManager.startStoreCardActivity(activity, customerId));
If you need more assistance, contact Developer and App Marketplace Support or ask for help in the Developer Forums.