Todas as indústrias do Pass têm casos de uso comuns. Por exemplo, todos os cartões de fidelidade, vales-presente, ofertas, ingressos de eventos, cartões de embarque para voos e bilhetes de transporte podem ser adicionados ao app Google Pay das seguintes maneiras:
Adicionar um botão da Web
Adicione o botão Salvar no Google Pay ao seu site para permitir que os usuários salvem cartões de fidelidade, vales-presente, ofertas, ingressos para eventos, cartões de embarque para voos e bilhetes de transporte no app Google Pay.
Quando um usuário clica no botão, um JSON Web Token (JWT) representando o cartão é enviado para servidores do Google. Em seguida, os servidores do Google criam o respectivo recurso Object com base no JWT e o conectam à conta do usuário.
Há três passos para integrar o botão Salvar no Google Pay ao site:
- Defina uma
Classestendida pelos objetos. - Gere um JWT que represente o
Object. - Adicione o botão Salvar no Google Pay à página da Web.
As etapas a seguir usam o cartão de fidelidade como exemplo, mas o processo usado é o mesmo em todos os tipos de cartões.
1. Definir uma classe estendida pelos objetos
Primeiro, defina a LoyaltyClass. Para inserir a LoyaltyClass, faça uma solicitação POST para o seguinte URI REST:
https://walletobjects.googleapis.com/walletobjects/v1/loyaltyClass
Para ativar a análise de erros rígida e capturar mais erros, como campos de códigos duplicados, adicione o parâmetro strict=true ao URI REST, conforme mostrado no seguinte URI de exemplo:
https://walletobjects.googleapis.com/walletobjects/v1/loyaltyClass?strict=true
O exemplo a seguir mostra um recurso JSON que representa uma LoyaltyClass. O JSON precisa ser enviado no corpo da solicitação POST. Mais especificamente, os exemplos de código a seguir demonstram como definir e inserir a LoyaltyClass.
Recurso
{
"accountIdLabel": "Member Id",
"accountNameLabel": "Member Name",
"id": "2945482443380251551.ExampleClass1",
"issuerName": "Baconrista",
"kind": "walletobjects#loyaltyClass",
"textModulesData": [
{
"header": "Rewards details",
"body": "Welcome to Baconrista rewards. Enjoy your rewards for being a loyal customer. " +
"10 points for every dollar spent. Redeem your points for free coffee, bacon and more!"
}
],
"linksModuleData": {
"uris": [
{
"kind": "walletobjects#uri",
"uri": "https://maps.google.com/map?q=google",
"description": "Nearby Locations"
},
{
"kind": "walletobjects#uri",
"uri": "tel:6505555555",
"description": "Call Customer Service"
}
]
},
"imageModulesData": [
{
"mainImage": {
"kind": "walletobjects#image",
"sourceUri": {
"kind": "walletobjects#uri",
"uri": "https://farm4.staticflickr.com/3738/12440799783_3dc3c20606_b.jpg",
"description": "Coffee beans"
}
}
}
],
"messages": [{
"header": "Welcome to Banconrista Rewards!",
"body": "Featuring our new bacon donuts.",
"kind": "walletobjects#walletObjectMessage"
}],
"locations": [{
"kind": "walletobjects#latLongPoint",
"latitude": 37.424015499999996,
"longitude": -122.09259560000001
},{
"kind": "walletobjects#latLongPoint",
"latitude": 37.424354,
"longitude": -122.09508869999999
},{
"kind": "walletobjects#latLongPoint",
"latitude": 37.7901435,
"longitude": -122.39026709999997
},{
"kind": "walletobjects#latLongPoint",
"latitude": 40.7406578,
"longitude": -74.00208940000002
}],
"programLogo": {
"kind": "walletobjects#image",
"sourceUri": {
"kind": "walletobjects#uri",
"uri": "https://farm8.staticflickr.com/7340/11177041185_a61a7f2139_o.jpg"
}
},
"programName": "Baconrista Rewards",
"rewardsTier": "Gold",
"rewardsTierLabel": "Tier",
"reviewStatus": "underReview",
"hexBackgroundColor": "#ffffff",
"heroImage": {
"kind": "walletobjects#image",
"sourceUri": {
"kind": "walletobjects#uri",
"uri": "https://farm8.staticflickr.com/7302/11177240353_115daa5729_o.jpg"
}
}
}
Java
// Define the Image Module Data
List<ImageModuleData> imageModuleData = new ArrayList<ImageModuleData>();
ImageModuleData image = new ImageModuleData().setMainImage(
new Image().setSourceUri(
new ImageUri().setUri("http://farm4.staticflickr.com/3738/12440799783_3dc3c20606_b.jpg")));
imageModuleData.add(image);
// Define Text Module Data
List<TextModuleData> textModulesData = new ArrayList<TextModuleData>();
TextModuleData textModuleData = new TextModuleData().setHeader("Rewards details")
.setBody(
"Welcome to Baconrista rewards. Enjoy your rewards for being a loyal customer. 10 points for ever dollar spent. Redeem your points for free coffee, bacon and more!");
textModulesData.add(textModuleData);
// Define Links Module Data
List<Uri> uris = new ArrayList<Uri>();
Uri uri1 = new Uri().setDescription("Nearby Locations").setUri("http://maps.google.com/?q=google");
Uri uri2 = new Uri().setDescription("Call Customer Service").setUri("tel:6505555555");
uris.add(uri1);
uris.add(uri2);
LinksModuleData linksModuleData = new LinksModuleData().setUris(uris);
// Define general messages
List<Message> messages = new ArrayList<Message>();
Message message = new Message()
.setHeader("Welcome to Baconrista")
.setBody("Featuring our new bacon donuts.");
messages.add(message);
// Define Geofence locations
List<LatLongPoint> locations = new ArrayList<LatLongPoint>();
locations.add(new LatLongPoint().setLatitude(37.422601).setLongitude(
-122.085286));
locations.add(new LatLongPoint().setLatitude(37.424354).setLongitude(
-122.09508869999999));
locations.add(new LatLongPoint().setLatitude(40.7406578).setLongitude(
-74.00208940000002));
// Create class
LoyaltyClass wobClass = new LoyaltyClass()
.setId('2945482443380251551.ExampleClass1')
.setIssuerName("Baconrista")
.setProgramName("Baconrista Rewards")
.setProgramLogo(
new Image().setSourceUri(new ImageUri()
.setUri("http://farm8.staticflickr.com/7340/11177041185_a61a7f2139_o.jpg")))
.setRewardsTierLabel("Tier").setRewardsTier("Gold")
.setImageModulesData(imageModuleData)
.setTextModulesData(textModulesData)
.setLinksModuleData(linksModuleData)
.setAccountNameLabel("Member Name").setAccountIdLabel("Member Id")
.setMessages(messages)
.setReviewStatus("underReview").setMultipleDevicesAndHoldersAllowedStatus("multipleHolders")
.setLocations(locations);
LoyaltyClass response = client.loyaltyclass().insert(wobClass).execute();
PHP
// Define text module data.
$textModulesData = array(
array(
'header' => 'Rewards details',
'body' => 'Welcome to Baconrista rewards. Enjoy your rewards for being a loyal customer. ' .
'10 points for every dollar spent. Redeem your points for free coffee, bacon and more!'
)
);
// Define links module data.
$linksModuleData = new Google_Service_Walletobjects_LinksModuleData();
$uris = array (
array(
'uri' => 'http://maps.google.com/map?q=google',
'kind' => 'walletobjecs#uri',
'description' => 'Nearby Locations'
),
array(
'uri' => 'tel:6505555555',
'kind' => 'walletobjecs#uri',
'description' => 'Call Customer Service'
)
);
$linksModuleData->setUris($uris);
$uriModuleImageInstance = new Google_Service_Walletobjects_ImageUri();
$uriModuleImageInstance->setUri(
'http://farm4.staticflickr.com/3738/12440799783_3dc3c20606_b.jpg'
);
$uriModuleImageInstance->setDescription('Coffee beans');
$imageModuleImageInstance = new Google_Service_Walletobjects_Image();
$imageModuleImageInstance->setSourceUri($uriModuleImageInstance);
$imagesModuleData = new Google_Service_Walletobjects_ImageModuleData();
$imagesModuleData->setMainImage($imageModuleImageInstance);
$imagesModuleDataArr = array ($imagesModuleData);
// Messages to be displayed to all users of Wallet Objects.
$messages = array(array(
'header' => 'Welcome to Banconrista Rewards!',
'body' => 'Featuring our new bacon donuts.',
'kind' => 'walletobjects#walletObjectMessage'
));
$locations = array(
array(
'kind' => 'walletobjects#latLongPoint',
'latitude' => 37.424015499999996,
'longitude' => -122.09259560000001
),
array(
'kind' => 'walletobjects#latLongPoint',
'latitude' => 37.424354,
'longitude' => -122.09508869999999
),
array(
'kind' => 'walletobjects#latLongPoint',
'latitude' => 37.7901435,
'longitude' => -122.39026709999997
),
array(
'kind' => 'walletobjects#latLongPoint',
'latitude' => 40.7406578,
'longitude' => -74.00208940000002
)
);
// Source uri of program logo.
$uriInstance = new Google_Service_Walletobjects_ImageUri();
$imageInstance = new Google_Service_Walletobjects_Image();
$uriInstance->setUri(
'http://farm8.staticflickr.com/7340/11177041185_a61a7f2139_o.jpg'
);
$imageInstance->setSourceUri($uriInstance);
// Create wallet class.
$wobClass = new Google_Service_Walletobjects_LoyaltyClass();
$wobClass->setId('2945482443380251551.ExampleClass1');
$wobClass->setIssuerName('Baconrista');
$wobClass->setProgramName('Baconrista Rewards');
$wobClass->setProgramLogo($imageInstance);
$wobClass->setRewardsTierLabel('Tier');
$wobClass->setRewardsTier('Gold');
$wobClass->setAccountNameLabel('Member Name');
$wobClass->setAccountIdLabel('Member Id');
$wobClass->setLinksModuleData($linksModuleData);
$wobClass->setTextModulesData($textModulesData);
$wobClass->setImageModulesData($imagesModuleDataArr);
$wobClass->setMessages($messages);
$wobClass->setReviewStatus('underReview');
$wobClass->setMultipleDevicesAndHoldersAllowedStatus('multipleHolders');
$wobClass->setLocations($locations);
$service->loyaltyclass->insert($wobClass);
Python
loyalty_class = {
'accountIdLabel': 'Member Id',
'accountNameLabel': 'Member Name',
'multipleDevicesAndHoldersAllowedStatus': 'multipleHolders',
'id': '2945482443380251551.ExampleClass1',
'issuerName': 'Baconrista',
'kind': 'walletobjects#loyaltyClass',
'locations': [{
'kind': 'walletobjects#latLongPoint',
'latitude': 37.424015499999996,
'longitude': -122.09259560000001
},{
'kind': 'walletobjects#latLongPoint',
'latitude': 37.424354,
'longitude': -122.09508869999999
},{
'kind': 'walletobjects#latLongPoint',
'latitude': 37.7901435,
'longitude': -122.39026709999997
},{
'kind': 'walletobjects#latLongPoint',
'latitude': 40.7406578,
'longitude': -74.00208940000002
}],
'textModulesData': [{
'header': 'Rewards details',
'body': 'Welcome to Baconrista rewards. Enjoy your rewards for being a loyal customer. ' +
'10 points for ever dollar spent. Redeem your points for free coffee, bacon and more! '
}],
'linksModuleData': {
'uris': [
{
'kind': 'walletobjects#uri',
'uri': 'http://maps.google.com/map?q=google',
'description': 'Nearby Locations'
},{
'kind': 'walletobjects#uri',
'uri': 'tel:6505555555',
'description': 'Call Customer Service'
}]
},
'imageModulesData': [
{
'mainImage': {
'kind': 'walletobjects#image',
'sourceUri': {
'kind': 'walletobjects#uri',
'uri': 'http://farm4.staticflickr.com/3738/12440799783_3dc3c20606_b.jpg',
'description': 'Coffee beans'
}
}
}
],
'messages': [{
'header': 'Welcome to Banconrista Rewards!',
'body': 'Featuring our new bacon donuts.',
'kind': 'walletobjects#walletObjectMessage'
}],
'programLogo': {
'kind': 'walletobjects#image',
'sourceUri': {
'kind': 'walletobjects#uri',
'uri': 'http://farm8.staticflickr.com/7340/11177041185_a61a7f2139_o.jpg'
}
},
'programName': 'Baconrista Rewards',
'rewardsTier': 'Gold',
'rewardsTierLabel': 'Tier',
'reviewStatus': 'underReview',
}
api_request = service.loyaltyclass().insert(body=loyalty_class)
api_response = api_request.execute()
Para ver a lista completa dos campos LoyaltyClass, consulte a
referência LoyaltyClass.
2. Gerar um JWT representando o objeto
Primeiro, defina o LoyaltyObject conforme mostrado nos snippets a seguir:
Recurso
{
"classId": "2945482443380251551.ExampleClass1",
"id": "2945482443380251551.ExampleObject1",
"accountId": "1234567890",
"accountName": "Jane Doe",
"barcode": {
"alternateText": "12345",
"type": "qrCode",
"value": "28343E3"
},
"textModulesData": [{
"header": "Jane's Baconrista Rewards",
"body": "Save more at your local Mountain View store Jane. " +
"You get 1 bacon fat latte for every 5 coffees purchased. " +
"Also just for you, 10% off all pastries in the Mountain View store."
}],
"linksModuleData": {
"uris": [
{
"kind": "walletobjects#uri",
"uri": "https://www.baconrista.com/myaccount?id=1234567890",
"description": "My Baconrista Account"
}]
},
"infoModuleData": {
"labelValueRows": [{
"columns": [{
"label": "Next Reward in",
"value": "2 coffees"
}, {
"label": "Member Since",
"value": "01/15/2013"
}]
}, {
"columns": [{
"label": "Local Store",
"value": "Mountain View"
}]
}],
"showLastUpdateTime": "true"
},
"loyaltyPoints": {
"balance": {
"string": "5000"
},
"label": "Points",
"pointsType": "points"
},
"messages": [{
"header": "Jane, welcome to Banconrista Rewards!",
"body": "Thanks for joining our program. Show this message to " +
"our barista for your first free coffee on us!"
}],
"state": "active"
}
Java
// Define Barcode
Barcode barcode = new Barcode().setType("qrCode")
.setValue("28343E3")
.setAlternateText("12345");
// Define Points
LoyaltyPoints points = new LoyaltyPoints()
.setLabel("Points")
.setPointsType("points")
.setBalance(new LoyaltyPointsBalance().setString("500"));
// Define Text Module Data
List<TextModuleData> textModulesData = new ArrayList<TextModuleData>();
TextModuleData textModuleData = new TextModuleData()
.setHeader("Jane's Baconrista Rewards")
.setBody(
"Save more at your local Mountain View store Jane. You get 1 bacon fat latte for every 5 coffees purchased. Also just for you, 10% off all pastries in the Mountain View store.");
textModulesData.add(textModuleData);
// Define Links Module Data
List<Uri> uris = new ArrayList<Uri>();
Uri uri1 = new Uri().setDescription("My Baconrista Account")
.setUri("http://www.baconrista.com/myaccount?id=1234567890");
uris.add(uri1);
LinksModuleData linksModuleData = new LinksModuleData().setUris(uris);
// Define Info Module
List<LabelValue> row0cols = new ArrayList<LabelValue>();
LabelValue row0col0 = new LabelValue().setLabel("Next Reward in")
.setValue("2 coffees");
LabelValue row0col1 = new LabelValue().setLabel("Member Since")
.setValue("01/15/2013");
row0cols.add(row0col0);
row0cols.add(row0col1);
List<LabelValue> row1cols = new ArrayList<LabelValue>();
LabelValue row1col0 = new LabelValue().setLabel("Local Store")
.setValue("Mountain View");
row1cols.add(row1col0);
List<LabelValueRow> rows = new ArrayList<LabelValueRow>();
LabelValueRow row0 = new LabelValueRow().setColumns(row0cols);
LabelValueRow row1 = new LabelValueRow().setColumns(row1cols);
rows.add(row0);
rows.add(row1);
InfoModuleData infoModuleData = new InfoModuleData()
.setShowLastUpdateTime(true)
.setLabelValueRows(rows);
// Define general messages
List<Message> messages = new ArrayList<Message>();
Message message = new Message()
.setHeader("Hi Jane!")
.setBody("Thanks for joining our program. Show this message to " +
"our barista for your first free coffee on us!");
messages.add(message);
// Define Wallet Instance
LoyaltyObject object = new LoyaltyObject()
.setClassId('2945482443380251551.ExampleClass1').setId('2945482443380251551.ExampleObject1')
.setState("active").setBarcode(barcode).setInfoModuleData(infoModuleData)
.setAccountName("Jane Doe").setTextModulesData(textModulesData)
.setMessages(messages).setLinksModuleData(linksModuleData)
.setAccountId("1234567890").setLoyaltyPoints(points);
PHP
$barcode = new Google_Service_Walletobjects_Barcode();
$barcode->setAlternateText('12345');
$barcode->setType('qrCode');
$barcode->setValue('28343E3');
// Define text module data.
$textModulesData = array(
array(
'header' => 'Janes Baconrista Rewards',
'body' => 'Save more at your local Mountain View store Jane. ' .
'You get 1 bacon fat latte for every 5 coffees purchased. ' .
'Also just for you, 10% off all pastries in the Mountain View store.'
)
);
// Define links module data.
$linksModuleData = new Google_Service_Walletobjects_LinksModuleData();
$uris = array (
array(
'uri' => 'http://www.baconrista.com/myaccount?id=1234567890',
'kind' => 'walletobjecs#uri',
'description' => 'My Baconrista Account'
)
);
$linksModuleData->setUris($uris);
// Define label values.
$labelValueRows = array(
array(
'columns' => array(
array(
'label' => 'Next Reward in',
'value' => '2 coffees'
), array(
'label' => 'Member Since',
'value' => '01/15/2013'
)
)
),
array(
'columns' => array(
array(
'label' => 'Local Store',
'value' => 'Mountain View'
)
)
)
);
// Define info module data.
$infoModuleData = new Google_Service_Walletobjects_InfoModuleData();
$infoModuleData->setShowLastUpdateTime(true);
$infoModuleData->setLabelValueRows($labelValueRows);
// Messages to be displayed.
$messages = array(array(
'header' => 'Jane, welcome to Banconrista Rewards!',
'body' => 'Thanks for joining our program. Show this message to '.
'our barista for your first free coffee on us!',
'kind' => 'walletobjects#walletObjectMessage'
));
// Reward points a user has.
$points = new Google_Service_Walletobjects_LoyaltyPoints();
$balance = new Google_Service_Walletobjects_LoyaltyPointsBalance();
$balance->setString('500');
$points->setBalance($balance);
$points->setLabel('Points');
$points->setPointsType('points');
// Create wallet object.
$wobObject = new Google_Service_Walletobjects_LoyaltyObject();
$wobObject->setClassId('2945482443380251551.ExampleClass1');
$wobObject->setId('2945482443380251551.ExampleObject1');
$wobObject->setState('active');
$wobObject->setBarcode($barcode);
$wobObject->setInfoModuleData($infoModuleData);
$wobObject->setLinksModuleData($linksModuleData);
$wobObject->setTextModulesData($textModulesData);
$wobObject->setAccountName('Jane Doe');
$wobObject->setAccountId('1234567890');
$wobObject->setLoyaltyPoints($points);
$wobObject->setMessages($messages);
Python
loyalty_object = {
'classId' : '2945482443380251551.ExampleClass1',
'id' : '2945482443380251551.ExampleObject1',
'accountId': '1234567890',
'accountName': 'Jane Doe',
'barcode': {
'alternateText' : '12345',
'type' : 'qrCode',
'value' : '28343E3'
},
'textModulesData': [{
'header': 'Jane\'s Baconrista Rewards',
'body': 'Save more at your local Mountain View store Jane. ' +
' You get 1 bacon fat latte for every 5 coffees purchased. ' +
'Also just for you, 10% off all pastries in the Mountain View store.'
}],
'linksModuleData': {
'uris': [
{
'kind': 'walletobjects#uri',
'uri': 'http://www.baconrista.com/myaccount?id=1234567890',
'description': 'My Baconrista Account'
}]
},
'infoModuleData': {
'labelValueRows': [{
'columns': [{
'label': 'Next Reward in',
'value': '2 coffees'
}, {
'label': 'Member Since',
'value': '01/15/2013'
}]
},{
'columns': [{
'label': 'Local Store',
'value': 'Mountain View'
}]
}],
'showLastUpdateTime': 'true'
},
'messages': [{
'header': 'Jane, welcome to Banconrista Rewards',
'body': 'Thanks for joining our program. Show this message to ' +
'our barista for your first free coffee on us!',
'kind': 'walletobjects#walletObjectMessage'
}],
'loyaltyPoints': {
'balance': {
'string': '500'
},
'label': 'Points',
'pointsType': 'points'
},
'state': 'active'
}
Codifique o LoyaltyObject em um JWT usando a chave particular da conta de serviço do OAuth 2.0. Os snippets a seguir mostram como codificar um JWT em várias linguagens. A guia do protocolo mostra um JWT não codificado. Para uma explicação sobre os campos no JWT, consulte o JWT da API Google Pay for Passes.
Protocolo
{
"iss": "example_service_account@developer.gserviceaccount.com",
"aud": "google",
"typ": "savetoandroidpay",
"iat": 1368029586,
"payload": {
"eventTicketClasses": [{
... //Event ticket Class JSON
}],
"eventTicketObjects": [{
... //Event ticket Object JSON
}],
"flightClasses": [{
... //Flight Class JSON
}],
"flightObjects": [{
... //Flight Object JSON
}],
"giftCardClasses": [{
... //Gift card Class JSON
}],
"giftCardObjects": [{
... //Gift card Object JSON
}],
"loyaltyClasses": [{
... //Loyalty Class JSON
}],
"loyaltyObjects": [{
... //Loyalty Object JSON
}],
"offerClasses": [{
... //Offer Class JSON
}],
"offerObjects": [{
... //Offer Object JSON
}],
"transitClasses": [{
... //Transit Class JSON
}],
"transitObjects": [{
... //Transit Object JSON
}]
},
"origins": ["http://baconrista.com", "https://baconrista.com"]
}
Java
WobCredentials credentials = null;
WobUtils utils = null;
// Instantiate the WobUtils class which contains handy functions
// Wob utils can be found in the quickstart sample
try {
credentials = new WobCredentials(
ServiceAccountEmailAddress,
ServiceAccountPrivateKeyPath,
ApplicationName,
IssuerId);
utils = new WobUtils(credentials);
} catch (GeneralSecurityException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
}
// Add valid domains for the Save to Wallet button
List<String> origins = new ArrayList<String>();
origins.add("http://baconrista.com");
origins.add("https://baconrista.com");
origins.add(req.getScheme() + "://" + req.getServerName() + ":" + req.getLocalPort());
//Generate Objects and Classes here
//........
WobPayload payload = new WobPayload();
payload.addObject({WalletObject/WalletClass});
// Convert the object into a Save to Android Pay Jwt
String jwt = null;
try {
jwt = utils.generateSaveJwt(payload, origins);
} catch (SignatureException e) {
e.printStackTrace();
}
PHP
$requestBody = [
"iss"=> SERVICE_ACCOUNT_EMAIL_ADDRESS,
"aud" => "google",
"typ" => "savetoandroidpay",
"iat"=> time(),
"payload" => {
"eventTicketClasses" => [ ], # Event ticket classes
"eventTicketObjects" => [ ], # Event ticket objects
"flightClasses" => [ ], # Flight classes
"flightObjects" => [ ], # Flight objects
"giftCardClasses" => [ ], # Gift card classes
"giftCardObjects" => [ ], # Gift card objects
"loyaltyClasses" => [ ], # Loyalty classes
"loyaltyObjects" => [ ], # Loyalty objects
"offerClasses" => [ ], # Offer classes
"offerObjects" => [ ], # Offer objects
"transitClasses" => [ ], # Transit classes
"transitObjects" => [ ] # Transit objects
},
"origins" => ["http://baconrista.com", "https://baconrista.com"]
]
// Generate the Save to Android Pay Jwt
echo $jwt = $assertObj->makeSignedJwt($requestBody, $client);
Python
jwt = {
'iss': config.SERVICE_ACCOUNT_EMAIL_ADDRESS,
'aud': 'google',
'typ': 'savetoandroidpay',
'iat': int(time.time()),
'payload': {
'webserviceResponse': {
'result': 'approved',
'message': 'Success.'
},
'eventTicketClasses': [], # Event ticket classes
'eventTicketObjects': [], # Event ticket objects
'flightClasses': [], # Flight classes
'flightObjects': [], # Flight objects
'giftCardClasses': [], # Gift card classes
'giftCardObjects': [], # Gift card objects
'loyaltyClasses': [], # Loyalty classes
'loyaltyObjects': [], # Loyalty objects
'offerClasses': [], # Offer classes
'offerObjects': [], # Offer objects
'transitClasses': [], # Transit classes
'transitObjects': [] # Transit objects
},
'origins' : ['http://baconrista.com', 'https://baconrista.com']
}
// Generate the Save to Android Pay Jwt
signer = crypt.Signer.from_string(app_key)
signed_jwt = crypt.make_signed_jwt(signer, jwt)
response = webapp2.Response(signed_jwt)
O comprimento seguro de um JWT codificado é 1.800 caracteres. Os JWTs precisam permanecer abaixo desse limite. Se o comprimento for superior a 1.800 caracteres, a gravação poderá não funcionar por causa do truncamento dos navegadores da Web. Os objetos codificados em JWTs precisam ser pequenos, contendo apenas dados específicos do usuário. Tente manter a maioria dos dados na classe do objeto, criando-a antes do JWT. Para objetos maiores que não caibam no limite, crie o objeto usando a API REST e envie apenas o código do objeto no JWT.
3. Adicionar o botão "Salvar no Google Pay"
Inclua o seguinte script na página em que você quer exibir o botão Salvar no Google Pay:
<script src="https://apis.google.com/js/platform.js" type="text/javascript"></script>
Em seguida, insira a tag de namespace g:savetoandroidpay que define o posicionamento e os atributos do botão Salvar no Google Pay. Inclua o JWT gerado anteriormente.
<g:savetoandroidpay jwt="{jwt_generated}" onsuccess="successHandler"
onfailure="failureHandler" size="small" theme="light" ></g:savetoandroidpay>
Você verá o botão Salvar no Google Pay na página da Web.
Para mais detalhes sobre o botão da Web do JavaScript, consulte a documentação de referência da API Google Pay for Passes para API Web.
Adicionar um link em um e-mail ou SMS
Para salvar o cartão no Google Pay usando um e-mail, inclua um botão no e-mail com o link direto.
Siga as três etapas abaixo para integrar o botão Salvar no Google Pay a um e-mail ou SMS:
- Defina uma
Classestendida pelos objetos. - Gere um JWT que represente o
Object. - Adicione o botão Salvar no Google Pay ao e-mail ou SMS.
As etapas a seguir usam o cartão de fidelidade como exemplo, mas o processo usado é o mesmo em todos os tipos de cartões.
1. Definir uma classe estendida pelos objetos
Primeiro, defina a LoyaltyClass. Para inserir a LoyaltyClass, faça uma solicitação POST para o seguinte URI REST:
https://walletobjects.googleapis.com/walletobjects/v1/loyaltyClass
Para ativar a análise de erros rígida e capturar mais erros, como campos de códigos duplicados, adicione o parâmetro strict=true ao URI REST, conforme mostrado no seguinte URI de exemplo:
https://walletobjects.googleapis.com/walletobjects/v1/loyaltyClass?strict=true
O exemplo a seguir mostra um recurso JSON que representa uma LoyaltyClass. O JSON precisa ser enviado no corpo da solicitação POST. Mais especificamente, os exemplos de código a seguir demonstram como definir e inserir a LoyaltyClass.
Recurso
{
"accountIdLabel": "Member Id",
"accountNameLabel": "Member Name",
"id": "2945482443380251551.ExampleClass1",
"issuerName": "Baconrista",
"kind": "walletobjects#loyaltyClass",
"textModulesData": [
{
"header": "Rewards details",
"body": "Welcome to Baconrista rewards. Enjoy your rewards for being a loyal customer. " +
"10 points for every dollar spent. Redeem your points for free coffee, bacon and more!"
}
],
"linksModuleData": {
"uris": [
{
"kind": "walletobjects#uri",
"uri": "https://maps.google.com/map?q=google",
"description": "Nearby Locations"
},
{
"kind": "walletobjects#uri",
"uri": "tel:6505555555",
"description": "Call Customer Service"
}
]
},
"imageModulesData": [
{
"mainImage": {
"kind": "walletobjects#image",
"sourceUri": {
"kind": "walletobjects#uri",
"uri": "https://farm4.staticflickr.com/3738/12440799783_3dc3c20606_b.jpg",
"description": "Coffee beans"
}
}
}
],
"messages": [{
"header": "Welcome to Banconrista Rewards!",
"body": "Featuring our new bacon donuts.",
"kind": "walletobjects#walletObjectMessage"
}],
"locations": [{
"kind": "walletobjects#latLongPoint",
"latitude": 37.424015499999996,
"longitude": -122.09259560000001
},{
"kind": "walletobjects#latLongPoint",
"latitude": 37.424354,
"longitude": -122.09508869999999
},{
"kind": "walletobjects#latLongPoint",
"latitude": 37.7901435,
"longitude": -122.39026709999997
},{
"kind": "walletobjects#latLongPoint",
"latitude": 40.7406578,
"longitude": -74.00208940000002
}],
"programLogo": {
"kind": "walletobjects#image",
"sourceUri": {
"kind": "walletobjects#uri",
"uri": "https://farm8.staticflickr.com/7340/11177041185_a61a7f2139_o.jpg"
}
},
"programName": "Baconrista Rewards",
"rewardsTier": "Gold",
"rewardsTierLabel": "Tier",
"reviewStatus": "underReview",
"hexBackgroundColor": "#ffffff",
"heroImage": {
"kind": "walletobjects#image",
"sourceUri": {
"kind": "walletobjects#uri",
"uri": "https://farm8.staticflickr.com/7302/11177240353_115daa5729_o.jpg"
}
}
}
Java
// Define the Image Module Data
List<ImageModuleData> imageModuleData = new ArrayList<ImageModuleData>();
ImageModuleData image = new ImageModuleData().setMainImage(
new Image().setSourceUri(
new ImageUri().setUri("http://farm4.staticflickr.com/3738/12440799783_3dc3c20606_b.jpg")));
imageModuleData.add(image);
// Define Text Module Data
List<TextModuleData> textModulesData = new ArrayList<TextModuleData>();
TextModuleData textModuleData = new TextModuleData().setHeader("Rewards details")
.setBody(
"Welcome to Baconrista rewards. Enjoy your rewards for being a loyal customer. 10 points for ever dollar spent. Redeem your points for free coffee, bacon and more!");
textModulesData.add(textModuleData);
// Define Links Module Data
List<Uri> uris = new ArrayList<Uri>();
Uri uri1 = new Uri().setDescription("Nearby Locations").setUri("http://maps.google.com/?q=google");
Uri uri2 = new Uri().setDescription("Call Customer Service").setUri("tel:6505555555");
uris.add(uri1);
uris.add(uri2);
LinksModuleData linksModuleData = new LinksModuleData().setUris(uris);
// Define general messages
List<Message> messages = new ArrayList<Message>();
Message message = new Message()
.setHeader("Welcome to Baconrista")
.setBody("Featuring our new bacon donuts.");
messages.add(message);
// Define Geofence locations
List<LatLongPoint> locations = new ArrayList<LatLongPoint>();
locations.add(new LatLongPoint().setLatitude(37.422601).setLongitude(
-122.085286));
locations.add(new LatLongPoint().setLatitude(37.424354).setLongitude(
-122.09508869999999));
locations.add(new LatLongPoint().setLatitude(40.7406578).setLongitude(
-74.00208940000002));
// Create class
LoyaltyClass wobClass = new LoyaltyClass()
.setId('2945482443380251551.ExampleClass1')
.setIssuerName("Baconrista")
.setProgramName("Baconrista Rewards")
.setProgramLogo(
new Image().setSourceUri(new ImageUri()
.setUri("http://farm8.staticflickr.com/7340/11177041185_a61a7f2139_o.jpg")))
.setRewardsTierLabel("Tier").setRewardsTier("Gold")
.setImageModulesData(imageModuleData)
.setTextModulesData(textModulesData)
.setLinksModuleData(linksModuleData)
.setAccountNameLabel("Member Name").setAccountIdLabel("Member Id")
.setMessages(messages)
.setReviewStatus("underReview").setMultipleDevicesAndHoldersAllowedStatus("multipleHolders")
.setLocations(locations);
LoyaltyClass response = client.loyaltyclass().insert(wobClass).execute();
PHP
// Define text module data.
$textModulesData = array(
array(
'header' => 'Rewards details',
'body' => 'Welcome to Baconrista rewards. Enjoy your rewards for being a loyal customer. ' .
'10 points for every dollar spent. Redeem your points for free coffee, bacon and more!'
)
);
// Define links module data.
$linksModuleData = new Google_Service_Walletobjects_LinksModuleData();
$uris = array (
array(
'uri' => 'http://maps.google.com/map?q=google',
'kind' => 'walletobjecs#uri',
'description' => 'Nearby Locations'
),
array(
'uri' => 'tel:6505555555',
'kind' => 'walletobjecs#uri',
'description' => 'Call Customer Service'
)
);
$linksModuleData->setUris($uris);
$uriModuleImageInstance = new Google_Service_Walletobjects_ImageUri();
$uriModuleImageInstance->setUri(
'http://farm4.staticflickr.com/3738/12440799783_3dc3c20606_b.jpg'
);
$uriModuleImageInstance->setDescription('Coffee beans');
$imageModuleImageInstance = new Google_Service_Walletobjects_Image();
$imageModuleImageInstance->setSourceUri($uriModuleImageInstance);
$imagesModuleData = new Google_Service_Walletobjects_ImageModuleData();
$imagesModuleData->setMainImage($imageModuleImageInstance);
$imagesModuleDataArr = array ($imagesModuleData);
// Messages to be displayed to all users of Wallet Objects.
$messages = array(array(
'header' => 'Welcome to Banconrista Rewards!',
'body' => 'Featuring our new bacon donuts.',
'kind' => 'walletobjects#walletObjectMessage'
));
$locations = array(
array(
'kind' => 'walletobjects#latLongPoint',
'latitude' => 37.424015499999996,
'longitude' => -122.09259560000001
),
array(
'kind' => 'walletobjects#latLongPoint',
'latitude' => 37.424354,
'longitude' => -122.09508869999999
),
array(
'kind' => 'walletobjects#latLongPoint',
'latitude' => 37.7901435,
'longitude' => -122.39026709999997
),
array(
'kind' => 'walletobjects#latLongPoint',
'latitude' => 40.7406578,
'longitude' => -74.00208940000002
)
);
// Source uri of program logo.
$uriInstance = new Google_Service_Walletobjects_ImageUri();
$imageInstance = new Google_Service_Walletobjects_Image();
$uriInstance->setUri(
'http://farm8.staticflickr.com/7340/11177041185_a61a7f2139_o.jpg'
);
$imageInstance->setSourceUri($uriInstance);
// Create wallet class.
$wobClass = new Google_Service_Walletobjects_LoyaltyClass();
$wobClass->setId('2945482443380251551.ExampleClass1');
$wobClass->setIssuerName('Baconrista');
$wobClass->setProgramName('Baconrista Rewards');
$wobClass->setProgramLogo($imageInstance);
$wobClass->setRewardsTierLabel('Tier');
$wobClass->setRewardsTier('Gold');
$wobClass->setAccountNameLabel('Member Name');
$wobClass->setAccountIdLabel('Member Id');
$wobClass->setLinksModuleData($linksModuleData);
$wobClass->setTextModulesData($textModulesData);
$wobClass->setImageModulesData($imagesModuleDataArr);
$wobClass->setMessages($messages);
$wobClass->setReviewStatus('underReview');
$wobClass->setMultipleDevicesAndHoldersAllowedStatus('multipleHolders');
$wobClass->setLocations($locations);
$service->loyaltyclass->insert($wobClass);
Python
loyalty_class = {
'accountIdLabel': 'Member Id',
'accountNameLabel': 'Member Name',
'multipleDevicesAndHoldersAllowedStatus': 'multipleHolders',
'id': '2945482443380251551.ExampleClass1',
'issuerName': 'Baconrista',
'kind': 'walletobjects#loyaltyClass',
'locations': [{
'kind': 'walletobjects#latLongPoint',
'latitude': 37.424015499999996,
'longitude': -122.09259560000001
},{
'kind': 'walletobjects#latLongPoint',
'latitude': 37.424354,
'longitude': -122.09508869999999
},{
'kind': 'walletobjects#latLongPoint',
'latitude': 37.7901435,
'longitude': -122.39026709999997
},{
'kind': 'walletobjects#latLongPoint',
'latitude': 40.7406578,
'longitude': -74.00208940000002
}],
'textModulesData': [{
'header': 'Rewards details',
'body': 'Welcome to Baconrista rewards. Enjoy your rewards for being a loyal customer. ' +
'10 points for ever dollar spent. Redeem your points for free coffee, bacon and more! '
}],
'linksModuleData': {
'uris': [
{
'kind': 'walletobjects#uri',
'uri': 'http://maps.google.com/map?q=google',
'description': 'Nearby Locations'
},{
'kind': 'walletobjects#uri',
'uri': 'tel:6505555555',
'description': 'Call Customer Service'
}]
},
'imageModulesData': [
{
'mainImage': {
'kind': 'walletobjects#image',
'sourceUri': {
'kind': 'walletobjects#uri',
'uri': 'http://farm4.staticflickr.com/3738/12440799783_3dc3c20606_b.jpg',
'description': 'Coffee beans'
}
}
}
],
'messages': [{
'header': 'Welcome to Banconrista Rewards!',
'body': 'Featuring our new bacon donuts.',
'kind': 'walletobjects#walletObjectMessage'
}],
'programLogo': {
'kind': 'walletobjects#image',
'sourceUri': {
'kind': 'walletobjects#uri',
'uri': 'http://farm8.staticflickr.com/7340/11177041185_a61a7f2139_o.jpg'
}
},
'programName': 'Baconrista Rewards',
'rewardsTier': 'Gold',
'rewardsTierLabel': 'Tier',
'reviewStatus': 'underReview',
}
api_request = service.loyaltyclass().insert(body=loyalty_class)
api_response = api_request.execute()
Para ver a lista completa dos campos LoyaltyClass, consulte a
referência LoyaltyClass.
2. Gerar um JWT representando o objeto
Primeiro, defina o LoyaltyObject conforme mostrado nos snippets a seguir:
Recurso
{
"classId": "2945482443380251551.ExampleClass1",
"id": "2945482443380251551.ExampleObject1",
"accountId": "1234567890",
"accountName": "Jane Doe",
"barcode": {
"alternateText": "12345",
"type": "qrCode",
"value": "28343E3"
},
"textModulesData": [{
"header": "Jane's Baconrista Rewards",
"body": "Save more at your local Mountain View store Jane. " +
"You get 1 bacon fat latte for every 5 coffees purchased. " +
"Also just for you, 10% off all pastries in the Mountain View store."
}],
"linksModuleData": {
"uris": [
{
"kind": "walletobjects#uri",
"uri": "https://www.baconrista.com/myaccount?id=1234567890",
"description": "My Baconrista Account"
}]
},
"infoModuleData": {
"labelValueRows": [{
"columns": [{
"label": "Next Reward in",
"value": "2 coffees"
}, {
"label": "Member Since",
"value": "01/15/2013"
}]
}, {
"columns": [{
"label": "Local Store",
"value": "Mountain View"
}]
}],
"showLastUpdateTime": "true"
},
"loyaltyPoints": {
"balance": {
"string": "5000"
},
"label": "Points",
"pointsType": "points"
},
"messages": [{
"header": "Jane, welcome to Banconrista Rewards!",
"body": "Thanks for joining our program. Show this message to " +
"our barista for your first free coffee on us!"
}],
"state": "active"
}
Java
// Define Barcode
Barcode barcode = new Barcode().setType("qrCode")
.setValue("28343E3")
.setAlternateText("12345");
// Define Points
LoyaltyPoints points = new LoyaltyPoints()
.setLabel("Points")
.setPointsType("points")
.setBalance(new LoyaltyPointsBalance().setString("500"));
// Define Text Module Data
List<TextModuleData> textModulesData = new ArrayList<TextModuleData>();
TextModuleData textModuleData = new TextModuleData()
.setHeader("Jane's Baconrista Rewards")
.setBody(
"Save more at your local Mountain View store Jane. You get 1 bacon fat latte for every 5 coffees purchased. Also just for you, 10% off all pastries in the Mountain View store.");
textModulesData.add(textModuleData);
// Define Links Module Data
List<Uri> uris = new ArrayList<Uri>();
Uri uri1 = new Uri().setDescription("My Baconrista Account")
.setUri("http://www.baconrista.com/myaccount?id=1234567890");
uris.add(uri1);
LinksModuleData linksModuleData = new LinksModuleData().setUris(uris);
// Define Info Module
List<LabelValue> row0cols = new ArrayList<LabelValue>();
LabelValue row0col0 = new LabelValue().setLabel("Next Reward in")
.setValue("2 coffees");
LabelValue row0col1 = new LabelValue().setLabel("Member Since")
.setValue("01/15/2013");
row0cols.add(row0col0);
row0cols.add(row0col1);
List<LabelValue> row1cols = new ArrayList<LabelValue>();
LabelValue row1col0 = new LabelValue().setLabel("Local Store")
.setValue("Mountain View");
row1cols.add(row1col0);
List<LabelValueRow> rows = new ArrayList<LabelValueRow>();
LabelValueRow row0 = new LabelValueRow().setColumns(row0cols);
LabelValueRow row1 = new LabelValueRow().setColumns(row1cols);
rows.add(row0);
rows.add(row1);
InfoModuleData infoModuleData = new InfoModuleData()
.setShowLastUpdateTime(true)
.setLabelValueRows(rows);
// Define general messages
List<Message> messages = new ArrayList<Message>();
Message message = new Message()
.setHeader("Hi Jane!")
.setBody("Thanks for joining our program. Show this message to " +
"our barista for your first free coffee on us!");
messages.add(message);
// Define Wallet Instance
LoyaltyObject object = new LoyaltyObject()
.setClassId('2945482443380251551.ExampleClass1').setId('2945482443380251551.ExampleObject1')
.setState("active").setBarcode(barcode).setInfoModuleData(infoModuleData)
.setAccountName("Jane Doe").setTextModulesData(textModulesData)
.setMessages(messages).setLinksModuleData(linksModuleData)
.setAccountId("1234567890").setLoyaltyPoints(points);
PHP
$barcode = new Google_Service_Walletobjects_Barcode();
$barcode->setAlternateText('12345');
$barcode->setType('qrCode');
$barcode->setValue('28343E3');
// Define text module data.
$textModulesData = array(
array(
'header' => 'Janes Baconrista Rewards',
'body' => 'Save more at your local Mountain View store Jane. ' .
'You get 1 bacon fat latte for every 5 coffees purchased. ' .
'Also just for you, 10% off all pastries in the Mountain View store.'
)
);
// Define links module data.
$linksModuleData = new Google_Service_Walletobjects_LinksModuleData();
$uris = array (
array(
'uri' => 'http://www.baconrista.com/myaccount?id=1234567890',
'kind' => 'walletobjecs#uri',
'description' => 'My Baconrista Account'
)
);
$linksModuleData->setUris($uris);
// Define label values.
$labelValueRows = array(
array(
'columns' => array(
array(
'label' => 'Next Reward in',
'value' => '2 coffees'
), array(
'label' => 'Member Since',
'value' => '01/15/2013'
)
)
),
array(
'columns' => array(
array(
'label' => 'Local Store',
'value' => 'Mountain View'
)
)
)
);
// Define info module data.
$infoModuleData = new Google_Service_Walletobjects_InfoModuleData();
$infoModuleData->setShowLastUpdateTime(true);
$infoModuleData->setLabelValueRows($labelValueRows);
// Messages to be displayed.
$messages = array(array(
'header' => 'Jane, welcome to Banconrista Rewards!',
'body' => 'Thanks for joining our program. Show this message to '.
'our barista for your first free coffee on us!',
'kind' => 'walletobjects#walletObjectMessage'
));
// Reward points a user has.
$points = new Google_Service_Walletobjects_LoyaltyPoints();
$balance = new Google_Service_Walletobjects_LoyaltyPointsBalance();
$balance->setString('500');
$points->setBalance($balance);
$points->setLabel('Points');
$points->setPointsType('points');
// Create wallet object.
$wobObject = new Google_Service_Walletobjects_LoyaltyObject();
$wobObject->setClassId('2945482443380251551.ExampleClass1');
$wobObject->setId('2945482443380251551.ExampleObject1');
$wobObject->setState('active');
$wobObject->setBarcode($barcode);
$wobObject->setInfoModuleData($infoModuleData);
$wobObject->setLinksModuleData($linksModuleData);
$wobObject->setTextModulesData($textModulesData);
$wobObject->setAccountName('Jane Doe');
$wobObject->setAccountId('1234567890');
$wobObject->setLoyaltyPoints($points);
$wobObject->setMessages($messages);
Python
loyalty_object = {
'classId' : '2945482443380251551.ExampleClass1',
'id' : '2945482443380251551.ExampleObject1',
'accountId': '1234567890',
'accountName': 'Jane Doe',
'barcode': {
'alternateText' : '12345',
'type' : 'qrCode',
'value' : '28343E3'
},
'textModulesData': [{
'header': 'Jane\'s Baconrista Rewards',
'body': 'Save more at your local Mountain View store Jane. ' +
' You get 1 bacon fat latte for every 5 coffees purchased. ' +
'Also just for you, 10% off all pastries in the Mountain View store.'
}],
'linksModuleData': {
'uris': [
{
'kind': 'walletobjects#uri',
'uri': 'http://www.baconrista.com/myaccount?id=1234567890',
'description': 'My Baconrista Account'
}]
},
'infoModuleData': {
'labelValueRows': [{
'columns': [{
'label': 'Next Reward in',
'value': '2 coffees'
}, {
'label': 'Member Since',
'value': '01/15/2013'
}]
},{
'columns': [{
'label': 'Local Store',
'value': 'Mountain View'
}]
}],
'showLastUpdateTime': 'true'
},
'messages': [{
'header': 'Jane, welcome to Banconrista Rewards',
'body': 'Thanks for joining our program. Show this message to ' +
'our barista for your first free coffee on us!',
'kind': 'walletobjects#walletObjectMessage'
}],
'loyaltyPoints': {
'balance': {
'string': '500'
},
'label': 'Points',
'pointsType': 'points'
},
'state': 'active'
}
Codifique o LoyaltyObject em um JWT usando a chave particular da conta de serviço do OAuth 2.0. Os snippets a seguir mostram como codificar um JWT em várias linguagens. A guia do protocolo mostra um JWT não codificado. Para uma explicação sobre os campos no JWT, consulte o JWT da API Google Pay for Passes.
Protocolo
{
"iss": "example_service_account@developer.gserviceaccount.com",
"aud": "google",
"typ": "savetoandroidpay",
"iat": 1368029586,
"payload": {
"eventTicketClasses": [{
... //Event ticket Class JSON
}],
"eventTicketObjects": [{
... //Event ticket Object JSON
}],
"flightClasses": [{
... //Flight Class JSON
}],
"flightObjects": [{
... //Flight Object JSON
}],
"giftCardClasses": [{
... //Gift card Class JSON
}],
"giftCardObjects": [{
... //Gift card Object JSON
}],
"loyaltyClasses": [{
... //Loyalty Class JSON
}],
"loyaltyObjects": [{
... //Loyalty Object JSON
}],
"offerClasses": [{
... //Offer Class JSON
}],
"offerObjects": [{
... //Offer Object JSON
}],
"transitClasses": [{
... //Transit Class JSON
}],
"transitObjects": [{
... //Transit Object JSON
}]
},
"origins": ["http://baconrista.com", "https://baconrista.com"]
}
Java
WobCredentials credentials = null;
WobUtils utils = null;
// Instantiate the WobUtils class which contains handy functions
// Wob utils can be found in the quickstart sample
try {
credentials = new WobCredentials(
ServiceAccountEmailAddress,
ServiceAccountPrivateKeyPath,
ApplicationName,
IssuerId);
utils = new WobUtils(credentials);
} catch (GeneralSecurityException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
}
// Add valid domains for the Save to Wallet button
List<String> origins = new ArrayList<String>();
origins.add("http://baconrista.com");
origins.add("https://baconrista.com");
origins.add(req.getScheme() + "://" + req.getServerName() + ":" + req.getLocalPort());
//Generate Objects and Classes here
//........
WobPayload payload = new WobPayload();
payload.addObject({WalletObject/WalletClass});
// Convert the object into a Save to Android Pay Jwt
String jwt = null;
try {
jwt = utils.generateSaveJwt(payload, origins);
} catch (SignatureException e) {
e.printStackTrace();
}
PHP
$requestBody = [
"iss"=> SERVICE_ACCOUNT_EMAIL_ADDRESS,
"aud" => "google",
"typ" => "savetoandroidpay",
"iat"=> time(),
"payload" => {
"eventTicketClasses" => [ ], # Event ticket classes
"eventTicketObjects" => [ ], # Event ticket objects
"flightClasses" => [ ], # Flight classes
"flightObjects" => [ ], # Flight objects
"giftCardClasses" => [ ], # Gift card classes
"giftCardObjects" => [ ], # Gift card objects
"loyaltyClasses" => [ ], # Loyalty classes
"loyaltyObjects" => [ ], # Loyalty objects
"offerClasses" => [ ], # Offer classes
"offerObjects" => [ ], # Offer objects
"transitClasses" => [ ], # Transit classes
"transitObjects" => [ ] # Transit objects
},
"origins" => ["http://baconrista.com", "https://baconrista.com"]
]
// Generate the Save to Android Pay Jwt
echo $jwt = $assertObj->makeSignedJwt($requestBody, $client);
Python
jwt = {
'iss': config.SERVICE_ACCOUNT_EMAIL_ADDRESS,
'aud': 'google',
'typ': 'savetoandroidpay',
'iat': int(time.time()),
'payload': {
'webserviceResponse': {
'result': 'approved',
'message': 'Success.'
},
'eventTicketClasses': [], # Event ticket classes
'eventTicketObjects': [], # Event ticket objects
'flightClasses': [], # Flight classes
'flightObjects': [], # Flight objects
'giftCardClasses': [], # Gift card classes
'giftCardObjects': [], # Gift card objects
'loyaltyClasses': [], # Loyalty classes
'loyaltyObjects': [], # Loyalty objects
'offerClasses': [], # Offer classes
'offerObjects': [], # Offer objects
'transitClasses': [], # Transit classes
'transitObjects': [] # Transit objects
},
'origins' : ['http://baconrista.com', 'https://baconrista.com']
}
// Generate the Save to Android Pay Jwt
signer = crypt.Signer.from_string(app_key)
signed_jwt = crypt.make_signed_jwt(signer, jwt)
response = webapp2.Response(signed_jwt)
O comprimento seguro de um JWT codificado é 1.800 caracteres. Os JWTs precisam permanecer abaixo desse limite. Se o comprimento for superior a 1.800 caracteres, a gravação poderá não funcionar por causa do truncamento dos navegadores da Web. Os objetos codificados em JWTs precisam ser pequenos, contendo apenas dados específicos do usuário. Tente manter a maioria dos dados na classe do objeto, criando-a antes do JWT. Para objetos maiores que não caibam no limite, crie o objeto usando a API REST e envie apenas o código do objeto no JWT.
3. Adicionar o botão Salvar no Google Pay ao e-mail ou SMS
Preencha o JWT gerado e o código da classe:
https://pay.google.com/gp/v/save/{jwt_generated}
Não se esqueça de incluir a barra no URL antes dos parâmetros.
O comprimento seguro de um URL de link direto é 1.800 caracteres. Os links diretos precisam permanecer abaixo desse limite. Se o comprimento for superior a 1.800 caracteres, a gravação poderá não funcionar por causa do truncamento dos navegadores da Web. Os objetos codificados em JWTs precisam ser pequenos, contendo apenas dados específicos do usuário. Tente manter a maioria dos dados na classe do objeto, criando-a antes do JWT. Para objetos maiores que não caibam no limite, considere a criação do objeto usando a API REST e o envio apenas do código do objeto no JWT.
Consulte as diretrizes para marcas para fazer o download e colocar a imagem do botão "Salvar no Google Pay" com o link. Para mais informações sobre links diretos e "Salvar no Google Pay", assista a introdução a links diretos para "Salvar no Android Pay" (em inglês).
O Gmail permite que botões no nível superior sejam colocados na linha do assunto de e-mails que usem ações "Ir para". Por exemplo, você pode incluir um botão chamado "Salvar no Google Pay", que será exibido na linha de assunto do e-mail e permitirá que o usuário salve a oferta diretamente pela caixa de entrada dele. Para ativá-lo, inclua uma ação de visualização no e-mail com o link direto acima.
De um app nativo para Android
Use os métodos a seguir para adicionar o botão Salvar no Google Pay ao seu app Android nativo:
Usar o método de intent e link do JWT
Siga estas etapas para salvar o cartão no Google Pay pelo app:
- Conclua as etapas em Adicionar o botão "Salvar no Google Pay" ao seu e-mail ou SMS.
Use uma intent
ACTION_VIEWpara abrir o link direto pelo botão Salvar no Google Pay.Verifique se o botão que aciona a intent usa as diretrizes da marca.
Veja a seguir um exemplo de resumo de fluxo:
- Em algum momento antes de salvar seu cartão, uma classe é criada no back-end com a API REST.
- Quando o usuário final pede para salvar um cartão, o back-end do servidor envia ao
app cliente para Android um
JWTque representa um objeto. - O app cliente para Android inclui um botão Salvar no Google Pay que segue nossas
diretrizes da marca.
Quando você clicar nele, uma intent
ACTION_VIEWserá aberta para um URI que contém o JWT no caminho. Veja um exemplo:https://pay.google.com/gp/v/save/{jwt_generated}
Usar o método de solicitação JWT POST
O método de solicitação JWT POST é uma alternativa usada na criação de classes e objetos de passagens aéreas ou ingressos de eventos em apps para Android. Ela é usada quando é muito difícil implementar o trabalho de back-end necessário para criar e inserir uma classe antes que um objeto seja salvo. Esse método é mais útil para ingressos de eventos e passagens aéreas, porque eles são cartões que podem ter várias classes criadas ao longo do tempo. Esse fluxo é resumido da seguinte forma:
- Quando o usuário final faz check-in no voo ou resgata o ingresso de um evento, o back-end do servidor renderiza um JWT para seu app cliente Android que inclui a classe e o objeto.
- O app cliente para Android inclui um botão Salvar no Google, que segue nossas diretrizes da marca. Veja o que acontece quando você seleciona essa opção:
- Uma solicitação
POSTenvia o JWT para um endpoint do Google por meio de HTTPS. - Um URI do corpo de resposta HTTP resultante é enviado de volta. Use-o
para abrir uma intent
ACTION_VIEW.
O método de solicitação JWT POST também requer uma
chave de API.
Ela é anexada como um parâmetro de consulta à chamada da API REST.
Criação de classes
Uma nova classe será criada no nosso back-end somente quando for apresentada com um class.id que não foi salvo anteriormente. Portanto, mesmo que você consiga transmitir os detalhes da classe para o Google por meio do JWT várias vezes, o back-end reconhece que a classe já está salva e não cria classes novas toda vez que um cartão de embarque é salvo.
Atualizações de classes
Após o primeiro cartão de embarque, o objeto é salvo com a classe. É possível usar o class.id com nossa API REST para executar as operações ADDMESSAGE, GET, LIST, PATCH e UPDATE, conforme o esperado.
Para alterar os detalhes da classe, use a API Class Update. Se você criar uma classe com class.id=XYZ e outros detalhes e depois tentar criar mais uma classe com class.id=XYZ, mas com detalhes diferentes, a classe original será mantida e nenhuma alteração será aplicada.
Formato JWT
O formato do JWT que você envia está descrito com detalhes na nossa documentação de referência sobre
o JWT da API Google Pay for Passes.
Nesse payload, é necessário transmitir uma entrada para objetos, que representa o objeto criado
por você, e uma entrada para classes, que contém a classe que você criou.
Solicitação HTTP
É possível usar o método INSERT para inserir classes e objetos especificados em um JWT. A chave da API precisa ser definida como um parâmetro de consulta.
Método JWT INSERT
Ao receber um JWT, o método INSERT insere as classes e objetos especificados no JWT. Caso esse processo seja bem-sucedido, você verá a mensagem de HTTP 200.
Solicitação HTTP
POST https://walletobjects.googleapis.com/walletobjects/v1/jwt/
Autorização
Esta solicitação não requer autorização. No entanto, o JWT precisa ser assinado com o método RSA-SHA256. A chave de assinatura é aquela gerada pela conta de serviço do OAuth.
Corpo da solicitação
No corpo da solicitação, forneça dados com a seguinte estrutura:
{ “jwt” : string }
Corpo da resposta
Se o método for bem-sucedido um corpo de resposta com a seguinte estrutura será exibido:
{
"saveUri": string,
"resources": {
"eventTicketClasses": [ eventTicketClass resource, ... ],
"eventTicketObjects": [ eventTicketObject resource, ... ],
"flightClasses": [ flightClass resource, ... ],
"flightObjects": [ flightObject resource, ... ],
"giftCardClasses": [ giftCardClass resource, ... ],
"giftCardObjects": [ giftCardObject resource, ... ],
"loyaltyClasses": [ loyaltyClass resource, ... ],
"loyaltyObjects": [ loyaltyObject resource, ... ],
"offerClasses": [ offerClass resource, ... ],
"offerObjects": [ offerObject resource, ... ],
"transitClasses": [ transitClass resource, ... ],
"transitObjects": [ transitObject resource, ... ]
}
}
Um saveUri é um URI que, quando aberto, permite que o usuário final salve os objetos identificados no JWT na própria Conta do Google. Esse URI é válido apenas uma semana após o
retorno.
Consulte a documentação de referência do endpoint do JWT para ver mais detalhes.
Diagramas de fluxo
Veja os fluxos comuns da API para diagramas de fluxo.
Usar o SDK nativo para Android
A API Android facilita a gravação do cartão no Google Pay. Integrando o botão Salvar no Google Pay no app, você facilita para os clientes a gravação do cartão no Google Pay.
Os passos a seguir descrevem como adicionar o botão Salvar no Google Pay para o cartão de fidelidade.
1. Adicionar o botão "Salvar no Google Pay" à IU
O primeiro passo é adicionar o botão "Salvar no Google Pay" ao seu app. O Google Pay oferece um botão do SDK do Android para fazer a integração ao aplicativo. Os recursos do botão estão disponíveis nas diretrizes da marca.
Este toolkit contém imagens vetoriais dos botões.
Para incorporar um botão ao aplicativo, copie a imagem do botão do toolkit para a pasta res do aplicativo e adicione o código a seguir ao arquivo de layout do Android. Cada botão exige a string contentDescription exclusiva e o valor minWidth, além do valor correto de src.
<ImageButton
android:layout_width="match_parent"
android:layout_height="48dp"
android:minWidth="200dp"
android:clickable="true"
android:src="@drawable/s2ap" />
A layout_height do botão é de 48 dp e a minWidth precisa ser de 200 dp.
2. Criar uma classe de fidelidade
Uma classe pode ser criada no Merchant Center da API do Google Pay for Passes. Na página "Classes" do Merchant Center, selecione Criar classe para criar a loyaltyclass.
Os campos de entrada com um contorno vermelho são obrigatórios, e os restantes são opcionais. Para qualquer campo com um URL, verifique se o link está acessível publicamente. A classe criada será referenciada durante a criação do objeto da fidelidade.
3. Criar um objeto de fidelidade
O próximo passo é criar o objeto de fidelidade. Este é um exemplo de criação de um objeto de fidelidade usando o padrão de construtor:
// Define Points
LoyaltyPoints points = LoyaltyPoints.newBuilder()
.setLabel("Points")
.setType("points")
.setBalance(LoyaltyPointsBalance.newBuilder().setString("500").build()).build();
// Define Text Module Data
List textModulesData = new ArrayList();
TextModuleData textModuleData = new TextModuleData("Jane's Baconrista Rewards", "Save more at your local Mountain View store Jane. You get 1 bacon fat latte for every 5 coffees purchased. Also just for you, 10% off all pastries in the Mountain View store.");
textModulesData.add(textModuleData);
// Define Links Module Data
List uris = new ArrayList();
UriData uri1 = new UriData("http://www.baconrista.com/myaccount?id=1234567890","My Baconrista Account");
uris.add(uri1);
List imageUris = new ArrayList();
UriData uri2 = new UriData("http://examplesite/images/exampleimage2.jpg", "Image Description");
imageUris.add(uri2);
// Define Info Module
List row0cols = new ArrayList();
LabelValue row0col0 = new LabelValue("Next Reward in","2 coffees");
LabelValue row0col1 = new LabelValue("Member Since", "01/15/2013");
row0cols.add(row0col0);
row0cols.add(row0col1);
List row1cols = new ArrayList();
LabelValue row1col0 = new LabelValue("Local Store", "Mountain View");
row1cols.add(row1col0);
List rows = new ArrayList();
LabelValueRow row0 = LabelValueRow.newBuilder().addColumns(row0cols).build();
LabelValueRow row1 = LabelValueRow.newBuilder().addColumns(row1cols).build();
rows.add(row0);
rows.add(row1);
// Define general messages
List messages = new ArrayList();
WalletObjectMessage message = WalletObjectMessage.newBuilder()
.setHeader("Hi Jane!")
.setBody("Thanks for joining our program. Show this message to " +
"our barista for your first free coffee on us!")
.build();
messages.add(message);
// Define Geolocations
LatLng location = new LatLng(37.422601, -122.085286);
List locations = new ArrayList();
locations.add(location);
LoyaltyWalletObject wob = LoyaltyWalletObject
.newBuilder()
.setClassId("2967745143867465930.LoyaltyClass")
.setId("2967745143867465930.LoyaltyObject")
.setState(WalletObjectsConstants.State.ACTIVE)
.setAccountId("1234567890")
.setAccountName("Jane Doe")
.setIssuerName("Baconrista")
.setProgramName("Baconrista Rewards")
.setBarcodeType("qrCode")
.setBarcodeValue("28343E3")
.setBarcodeAlternateText("12345")
.setLoyaltyPoints(points)
.addTextModulesData(textModulesData)
.addLinksModuleDataUris(uris)
.addInfoModuleDataLabelValueRows(rows)
.addImageModuleDataMainImageUris(imageUris)
.addMessages(messages)
.addLocations(locations)
.build();
Este objeto é o primeiro parâmetro recebido pela chamada createWalletObject descrita na próxima seção.
4. Inicializar a solicitação para salvar o objeto de fidelidade
A classe
walletObjectsClient
funciona como ponto de entrada da funcionalidade de objetos do Wallet.
O seguinte snippet de código ilustra como um app pode instanciar um cliente para salvar um objeto no Google Pay:
CreateWalletObjectsRequest request = new CreateWalletObjectsRequest(wob);
Wallet.WalletOptions walletOptions = new Wallet.WalletOptions.Builder()
.setTheme(WalletConstants.THEME_LIGHT)
.setEnvironment(WalletConstants.ENVIRONMENT_PRODUCTION)
.build();
walletObjectsClient = Wallet.getWalletObjectsClient(this, walletOptions);
Task task = walletObjectsClient.createWalletObjects(request);
AutoResolveHelper.resolveTask(task, this, SAVE_TO_ANDROID);
Também é possível usar o GoogleApiClient para inicializar uma solicitação:
Wallet.WalletObjects.createWalletObjects(googleApiClient, request, SAVE_TO_ANDROID);
5. Processar onActivityResult
Defina onActivityResult para reagir ao sucesso, cancelamento ou falha da operação, conforme mostrado:
public void onActivityResult(int requestCode, int resultCode, Intent data){
EditText textBox = (EditText) findViewById(R.id.s2wResponse);
switch(requestCode){
case SAVE_TO_ANDROID:
switch (resultCode) {
case Activity.RESULT_OK:
textBox.setText("saved");
break;
case Activity.RESULT_CANCELED:
textBox.setText("canceled");
break;
default:
int errorCode =
data.getIntExtra(
WalletConstants.EXTRA_ERROR_CODE, -1);
textBox.setText("failed error code: " + errorCode);
break;
}