Response
Stay organized with collections
Save and categorize content based on your preferences.
Object sent during authentication response.
Here's an example of a clear text JSON response:
{
"associationId": "88ydEE-ioiwe==",
"requestId": "375dhjf9-Uydd="
}
The AuthenticationResponse
is encrypted and signed using PGP or JWE+JWS. Further, this value is web-safe base64 encoded. This encoding is referred to below as Base64UrlEncode
. In other words, the clear text JSON version of the AuthenticationRequest
must be passed through the following functions:
Base64UrlEncode(
PGPSignAndEncrypt(
{
"associationId": "88ydEE-ioiwe==",
"requestId": "375dhjf9-Uydd="
}
)
)
or
Base64UrlEncode(
JWSignAndEncrypt(
{
"associationId": "88ydEE-ioiwe==",
"requestId": "375dhjf9-Uydd="
}
)
)
JSON representation |
{
"associationId": string,
"requestId": string,
"authenticationResult": {
object (AuthenticationResult )
}
} |
Fields |
associationId |
string
OPTIONAL: Reflected back by the payment integrator to Google. This allows Google to check that the associationId passed back is the same associationId passed in. This is required if it is present on the request.
|
requestId |
string
REQUIRED: Reflected back by the payment integrator to Google. This allows Google to prevent replay attacks.
|
authenticationResult |
object (AuthenticationResult )
OPTIONAL: The result of the authentication. For flows where there is no subsequent call to the Payment Integrator after the authentication has taken place, the result must be included in the response to ensure the integrity of the result.
|
AuthenticationResult
The result of the authentication.
JSON representation |
{
// Union field result can be only one of the following:
"success": {
object (Empty )
},
"cancelled": {
object (Empty )
},
"fatalError": {
object (Empty )
}
// End of list of possible types for union field result .
} |
Fields |
Union field result . REQUIRED: The result of the authentication. result can be only one of the following: |
success |
object (Empty )
Authentication was successful.
|
cancelled |
object (Empty )
User canceled the flow manually and the flow should be aborted.
|
fatalError |
object (Empty )
Authentication failed for a fatal reason and the flow should be aborted.
|
All rights reserved. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-29 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-29 UTC."],[[["\u003cp\u003eAuthenticationResponse is an object sent during the authentication response, containing associationId, requestId, and authenticationResult.\u003c/p\u003e\n"],["\u003cp\u003eThe response is encrypted, signed (using PGP or JWE+JWS), and then base64 encoded for security.\u003c/p\u003e\n"],["\u003cp\u003eAuthenticationResult indicates the outcome with three possible values: success, cancelled, or fatalError.\u003c/p\u003e\n"],["\u003cp\u003eassociationId and requestId are used for tracking and security purposes to ensure the integrity of the request and response.\u003c/p\u003e\n"]]],["The `AuthenticationResponse` contains `associationId` (optional) and `requestId` (required), which are sent back to Google for verification. This response is encrypted using PGP or JWE+JWS, then encoded using Base64UrlEncode. The `authenticationResult` object indicates the outcome, which can be `success`, `cancelled` (user initiated), or `fatalError` (failed). The json representation is used to transmit the information between the entities. `associationId` is present to check it matches the one in the request, while `requestId` helps to prevent replay attacks.\n"],null,["# Response\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [AuthenticationResult](#AuthenticationResult)\n - [JSON representation](#AuthenticationResult.SCHEMA_REPRESENTATION)\n\nObject sent during authentication response.\n\nHere's an example of a clear text JSON response: \n\n\n {\n \"associationId\": \"88ydEE-ioiwe==\",\n \"requestId\": \"375dhjf9-Uydd=\"\n }\n\nThe `AuthenticationResponse` is encrypted and signed using PGP or JWE+JWS. Further, this value is web-safe base64 encoded. This encoding is referred to below as `Base64UrlEncode`. In other words, the clear text JSON version of the `AuthenticationRequest` must be passed through the following functions: \n\n Base64UrlEncode(\n PGPSignAndEncrypt(\n {\n \"associationId\": \"88ydEE-ioiwe==\",\n \"requestId\": \"375dhjf9-Uydd=\"\n }\n )\n )\n\nor \n\n Base64UrlEncode(\n JWSignAndEncrypt(\n {\n \"associationId\": \"88ydEE-ioiwe==\",\n \"requestId\": \"375dhjf9-Uydd=\"\n }\n )\n )\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"associationId\": string, \"requestId\": string, \"authenticationResult\": { object (/pay/e-wallets-v1/payment-integrator-e-wallets-api/Response#AuthenticationResult) } } ``` |\n\n| Fields ||\n|------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `associationId` | `string` **OPTIONAL**: Reflected back by the payment integrator to Google. This allows Google to check that the associationId passed back is the same associationId passed in. This is required if it is present on the request. |\n| `requestId` | `string` **REQUIRED**: Reflected back by the payment integrator to Google. This allows Google to prevent replay attacks. |\n| `authenticationResult` | `object (`[AuthenticationResult](/pay/e-wallets-v1/payment-integrator-e-wallets-api/Response#AuthenticationResult)`)` **OPTIONAL**: The result of the authentication. For flows where there is no subsequent call to the Payment Integrator after the authentication has taken place, the result must be included in the response to ensure the integrity of the result. |\n\nAuthenticationResult\n--------------------\n\nThe result of the authentication.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { // Union field `result` can be only one of the following: \"success\": { object (/pay/e-wallets-v1/payment-integrator-e-wallets-api/Empty) }, \"cancelled\": { object (/pay/e-wallets-v1/payment-integrator-e-wallets-api/Empty) }, \"fatalError\": { object (/pay/e-wallets-v1/payment-integrator-e-wallets-api/Empty) } // End of list of possible types for union field `result`. } ``` |\n\n| Fields ||\n|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Union field `result`. **REQUIRED** : The result of the authentication. `result` can be only one of the following: ||\n| `success` | `object (`[Empty](/pay/e-wallets-v1/payment-integrator-e-wallets-api/Empty)`)` Authentication was successful. |\n| `cancelled` | `object (`[Empty](/pay/e-wallets-v1/payment-integrator-e-wallets-api/Empty)`)` User canceled the flow manually and the flow should be aborted. |\n| `fatalError` | `object (`[Empty](/pay/e-wallets-v1/payment-integrator-e-wallets-api/Empty)`)` Authentication failed for a fatal reason and the flow should be aborted. |"]]