Google is committed to advancing racial equity for Black communities. See how.

PayClient

public interface PayClient implements HasApiKey<Api.ApiOptions.NotRequiredOptions>

Interface for Pay API.

Nested Class Summary

@interface PayClient.RequestType All possible request types that will be used by callers of PayClient.getPayApiAvailabilityStatus(int)
@interface PayClient.SavePassesResult Possible result codes passed back in onActivityResult() when calling PayClient.savePasses(String, Activity, int) or PayClient.savePassesJwt(String, Activity, int)

Constant Summary

String EXTRA_API_ERROR_MESSAGE Debug message passed back in onActivityResult() when calling savePasses(String, Activity, int) or savePassesJwt(String, Activity, int).

Public Method Summary

abstract Task<Integer>
getPayApiAvailabilityStatus(int requestType)
Gets the PayApiAvailabilityStatus of the current user and device.
abstract void
savePasses(String json, Activity activity, int requestCode)
Saves one or multiple passes in a JSON format.
abstract void
savePassesJwt(String jwt, Activity activity, int requestCode)
Saves one or multiple passes in a JWT format.

Constants

public static final String EXTRA_API_ERROR_MESSAGE

Debug message passed back in onActivityResult() when calling savePasses(String, Activity, int) or savePassesJwt(String, Activity, int).

public void onActivityResult(int requestCode, int resultCode, Intent data) {
   ...
   if (resultCode == PayClient.SavePassesResult.SAVE_ERROR && data != null) {
     String errorMessage = data.getStringExtra(PayClient.EXTRA_API_ERROR_MESSAGE);
     ...
   }
   ...
 }
 
Constant Value: "extra_api_error_message"

Public Methods

public abstract Task<Integer> getPayApiAvailabilityStatus (int requestType)

Gets the PayApiAvailabilityStatus of the current user and device.

Parameters
requestType A PayClient.RequestType for how the API will be used.
Returns

public abstract void savePasses (String json, Activity activity, int requestCode)

Saves one or multiple passes in a JSON format.

Must be called from an Activity.

Parameters
json A JSON string request to save one or multiple passes. The JSON format is consistent with the JWT save link format. Refer to Google Pay API for Passes for an overview on how save links are generated. Only focus on how the JSON is formatted. There is no need to sign the JSON string.
activity The Activity that will receive the callback result.
requestCode An integer request code that will be passed back in onActivityResult(), allowing you to identify whom this result came from.

public abstract void savePassesJwt (String jwt, Activity activity, int requestCode)

Saves one or multiple passes in a JWT format.

Must be called from an Activity.

Parameters
jwt A JWT string token to save one or multiple passes. The token format is the same used in the JWT save link format. Refer to Google Pay API for Passes for an overview on how save links are generated.
activity The Activity that will receive the callback result.
requestCode An integer request code that will be passed back in onActivityResult(), allowing you to identify whom this result came from.