REST Resource: issuer
Stay organized with collections
Save and categorize content based on your preferences.
Resource: Issuer
| Fields |
issuerId |
string (int64 format)
The unique identifier for an issuer account. This is automatically generated when the issuer is inserted.
|
name |
string
The account name of the issuer.
|
contactInfo |
object (IssuerContactInfo)
Issuer contact information.
|
homepageUrl |
string
URL for the issuer's home page.
|
smartTapMerchantData |
object (SmartTapMerchantData)
Available only to Smart Tap enabled partners. Contact support for additional guidance.
|
callbackOptions |
object (CallbackOptions)
Allows the issuer to provide their callback settings.
|
SmartTapMerchantData
| JSON representation |
{
"smartTapMerchantId": string,
"authenticationKeys": [
{
object (AuthenticationKey)
}
]
} |
| Fields |
smartTapMerchantId |
string (int64 format)
Available only to Smart Tap enabled partners. Contact support for additional guidance.
|
authenticationKeys[] |
object (AuthenticationKey)
Available only to Smart Tap enabled partners. Contact support for additional guidance.
|
AuthenticationKey
| JSON representation |
{
"id": integer,
"publicKeyPem": string
} |
| Fields |
id |
integer
Available only to Smart Tap enabled partners. Contact support for additional guidance.
|
publicKeyPem |
string
Available only to Smart Tap enabled partners. Contact support for additional guidance.
|
Methods |
|
|
Returns the issuer with the given issuer ID. |
|
|
Inserts an issuer with the given ID and properties. |
|
|
Returns a list of all issuers shared to the caller. |
|
|
Updates the issuer referenced by the given issuer ID. |
|
|
Updates the issuer referenced by the given issuer ID. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-03-13 UTC.
[null,null,["Last updated 2025-03-13 UTC."],[[["\u003cp\u003eGoogle Wallet Issuers are entities that can distribute passes to users, containing information like contact details and Smart Tap merchant data for enabled partners.\u003c/p\u003e\n"],["\u003cp\u003eIssuers are identified by a unique \u003ccode\u003eissuerId\u003c/code\u003e and have associated resources such as \u003ccode\u003eIssuerContactInfo\u003c/code\u003e, \u003ccode\u003eSmartTapMerchantData\u003c/code\u003e, and \u003ccode\u003eAuthenticationKey\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can manage issuers through a REST API with methods to get, insert, list, patch, and update issuer information.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eSmartTapMerchantData\u003c/code\u003e and \u003ccode\u003eAuthenticationKey\u003c/code\u003e are reserved for Smart Tap partners and require contacting Google support for access and guidance.\u003c/p\u003e\n"],["\u003cp\u003eIssuers can configure callback settings using \u003ccode\u003ecallbackOptions\u003c/code\u003e for receiving notifications about events related to their passes.\u003c/p\u003e\n"]]],["This document details issuer account data structures and methods. An issuer includes an `issuerId`, `name`, `contactInfo`, `homepageUrl`, and `callbackOptions`. `IssuerContactInfo` includes `name`, `phone`, `email`, and `alertsEmails`. `SmartTapMerchantData` stores `smartTapMerchantId` and `authenticationKeys`. `AuthenticationKey` contains an `id` and `publicKeyPem`. Key actions include using methods like `get`, `insert`, `list`, `patch`, and `update` to manage issuer information.\n"],null,["# REST Resource: issuer\n\n- [Resource: Issuer](#Issuer)\n - [JSON representation](#Issuer.SCHEMA_REPRESENTATION)\n- [IssuerContactInfo](#IssuerContactInfo)\n - [JSON representation](#IssuerContactInfo.SCHEMA_REPRESENTATION)\n- [SmartTapMerchantData](#SmartTapMerchantData)\n - [JSON representation](#SmartTapMerchantData.SCHEMA_REPRESENTATION)\n- [AuthenticationKey](#AuthenticationKey)\n - [JSON representation](#AuthenticationKey.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Issuer\n----------------\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"issuerId\": string, \"name\": string, \"contactInfo\": { object (/wallet/reference/rest/v1/issuer#IssuerContactInfo) }, \"homepageUrl\": string, \"smartTapMerchantData\": { object (/wallet/reference/rest/v1/issuer#SmartTapMerchantData) }, \"callbackOptions\": { object (/wallet/reference/rest/v1/CallbackOptions) } } ``` |\n\n| Fields ||\n|------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `issuerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The unique identifier for an issuer account. This is automatically generated when the issuer is inserted. |\n| `name` | `string` The account name of the issuer. |\n| `contactInfo` | `object (`[IssuerContactInfo](/wallet/reference/rest/v1/issuer#IssuerContactInfo)`)` Issuer contact information. |\n| `homepageUrl` | `string` URL for the issuer's home page. |\n| `smartTapMerchantData` | `object (`[SmartTapMerchantData](/wallet/reference/rest/v1/issuer#SmartTapMerchantData)`)` Available only to Smart Tap enabled partners. Contact support for additional guidance. |\n| `callbackOptions` | `object (`[CallbackOptions](/wallet/reference/rest/v1/CallbackOptions)`)` Allows the issuer to provide their callback settings. |\n\nIssuerContactInfo\n-----------------\n\n| JSON representation |\n|------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"phone\": string, \"email\": string, \"alertsEmails\": [ string ] } ``` |\n\n| Fields ||\n|------------------|-----------------------------------------------------|\n| `name` | `string` The primary contact name. |\n| `phone` | `string` The primary contact phone number. |\n| `email` | `string` The primary contact email address. |\n| `alertsEmails[]` | `string` Email addresses which will receive alerts. |\n\nSmartTapMerchantData\n--------------------\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"smartTapMerchantId\": string, \"authenticationKeys\": [ { object (/wallet/reference/rest/v1/issuer#AuthenticationKey) } ] } ``` |\n\n| Fields ||\n|------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `smartTapMerchantId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Available only to Smart Tap enabled partners. Contact support for additional guidance. |\n| `authenticationKeys[]` | `object (`[AuthenticationKey](/wallet/reference/rest/v1/issuer#AuthenticationKey)`)` Available only to Smart Tap enabled partners. Contact support for additional guidance. |\n\nAuthenticationKey\n-----------------\n\n| JSON representation |\n|---------------------------------------------------|\n| ``` { \"id\": integer, \"publicKeyPem\": string } ``` |\n\n| Fields ||\n|----------------|--------------------------------------------------------------------------------------------------|\n| `id` | `integer` Available only to Smart Tap enabled partners. Contact support for additional guidance. |\n| `publicKeyPem` | `string` Available only to Smart Tap enabled partners. Contact support for additional guidance. |\n\n| Methods ------- ||\n|-------------------------------------------------------|-------------------------------------------------------|\n| ### [get](/wallet/reference/rest/v1/issuer/get) | Returns the issuer with the given issuer ID. |\n| ### [insert](/wallet/reference/rest/v1/issuer/insert) | Inserts an issuer with the given ID and properties. |\n| ### [list](/wallet/reference/rest/v1/issuer/list) | Returns a list of all issuers shared to the caller. |\n| ### [patch](/wallet/reference/rest/v1/issuer/patch) | Updates the issuer referenced by the given issuer ID. |\n| ### [update](/wallet/reference/rest/v1/issuer/update) | Updates the issuer referenced by the given issuer ID. |"]]
