RedirectResponse
Stay organized with collections
Save and categorize content based on your preferences.
Response object for the Complete Redirect flow.
Here's an example of a clear text JSON request:
{
"redirectRequestId": "cmVxdWVzdDE",
"result": {
"success": {}
},
"formOfPayment": {
"issuerId": {
"value": "123ABC"
}
}
}
The RedirectResponse
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 RedirectResponse
must be passed through the following functions:
Base64UrlEncode(
PGPSignAndEncrypt(
{
"redirectRequestId": "cmVxdWVzdDE",
"result": {
"success": {}
},
"formOfPayment": {
"issuerId": {
"value": "123ABC"
}
}
}
)
)
or
Base64UrlEncode(
JWSignAndEncrypt(
{
"redirectRequestId": "cmVxdWVzdDE",
"result": {
"success": {}
},
"formOfPayment": {
"issuerId": {
"value": "123ABC"
}
}
}
)
)
JSON representation |
{
"redirectRequestId": string,
"formOfPayment": {
object (FormOfPayment)
},
// Union field redirectResult can be only one of the following:
"result": {
object (RedirectPaymentResult)
},
"errorResponse": {
object (CompleteRedirectErrorResponse )
}
// End of list of possible types for union field redirectResult .
} |
Fields |
redirectRequestId |
string
REQUIRED: Unique identifier of the initiating redirect request. This is a string that has a max length of 100 characters, and contains only the characters "a-z", "A-Z", "0-9", ":", "-", and "_".
|
formOfPayment |
object (FormOfPayment)
OPTIONAL: The form of payment that the user selected for this payment. If the user made no choice or it does not apply, this should be set to noneChosen . Required to be set when result is set.
|
Union field redirectResult . REQUIRED: The result of the redirect payment. redirectResult can be only one of the following: |
result |
object (RedirectPaymentResult)
Result of this redirect payment if it was successful, declined, or pending.
|
errorResponse |
object (CompleteRedirectErrorResponse )
Details if the redirect failed because of an error. Redirect payments that receive this reply are kept open, and the integrator can later send a redirectPaymentCompleteNotification if the payment was successful or declined.
|
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\u003eThe \u003ccode\u003eRedirectResponse\u003c/code\u003e object, returned after a Complete Redirect flow, is encrypted, signed (using PGP or JWE+JWS), and web-safe base64 encoded.\u003c/p\u003e\n"],["\u003cp\u003eIt contains details about the redirect request, including a unique identifier (\u003ccode\u003eredirectRequestId\u003c/code\u003e), the selected form of payment (\u003ccode\u003eformOfPayment\u003c/code\u003e), and the result of the payment (\u003ccode\u003eresult\u003c/code\u003e or \u003ccode\u003eerrorResponse\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eIf successful, the \u003ccode\u003eresult\u003c/code\u003e field provides information about the payment outcome; if unsuccessful, the \u003ccode\u003eerrorResponse\u003c/code\u003e field contains details about the error.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eformOfPayment\u003c/code\u003e is optional and should be set to \u003ccode\u003enoneChosen\u003c/code\u003e if the user made no choice or it doesn't apply, but it is required when \u003ccode\u003eresult\u003c/code\u003e is present.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eredirectRequestId\u003c/code\u003e is a mandatory string with a maximum length of 100 characters, containing only alphanumeric characters, colon, hyphen, and underscore.\u003c/p\u003e\n"]]],["The `RedirectResponse` is a JSON object containing information about a redirect payment. It includes a `redirectRequestId`, an optional `formOfPayment` object, and one of two fields within the union field `redirectResult`: `result` for successful or pending outcomes, or `errorResponse` for failures. The JSON is encrypted via PGP or JWE+JWS, then encoded using `Base64UrlEncode`. The `redirectRequestId` is a unique string, and the response is required when a result is present.\n"],null,["- [JSON representation](#SCHEMA_REPRESENTATION)\n\nResponse object for the Complete Redirect flow.\n\nHere's an example of a clear text JSON request: \n\n\n {\n \"redirectRequestId\": \"cmVxdWVzdDE\",\n \"result\": {\n \"success\": {}\n },\n \"formOfPayment\": {\n \"issuerId\": {\n \"value\": \"123ABC\"\n }\n }\n }\n\nThe `RedirectResponse` 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 `RedirectResponse` must be passed through the following functions: \n\n Base64UrlEncode(\n PGPSignAndEncrypt(\n {\n \"redirectRequestId\": \"cmVxdWVzdDE\",\n \"result\": {\n \"success\": {}\n },\n \"formOfPayment\": {\n \"issuerId\": {\n \"value\": \"123ABC\"\n }\n }\n }\n )\n )\n\nor \n\n Base64UrlEncode(\n JWSignAndEncrypt(\n {\n \"redirectRequestId\": \"cmVxdWVzdDE\",\n \"result\": {\n \"success\": {}\n },\n \"formOfPayment\": {\n \"issuerId\": {\n \"value\": \"123ABC\"\n }\n }\n }\n )\n )\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"redirectRequestId\": string, \"formOfPayment\": { object (/pay/redirect-fop-v1/payment-integrator-redirect-fop-api/FormOfPayment) }, // Union field `redirectResult` can be only one of the following: \"result\": { object (/pay/redirect-fop-v1/payment-integrator-redirect-fop-api/getRedirectPaymentStatus#RedirectPaymentResult) }, \"errorResponse\": { object (/pay/redirect-fop-v1/google-redirect-fop-api/CompleteRedirectErrorResponse) } // End of list of possible types for union field `redirectResult`. } ``` |\n\n| Fields ||\n|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `redirectRequestId` | `string` **REQUIRED**: Unique identifier of the initiating redirect request. This is a string that has a max length of 100 characters, and contains only the characters \"a-z\", \"A-Z\", \"0-9\", \":\", \"-\", and \"_\". |\n| `formOfPayment` | `object (`[FormOfPayment](/pay/redirect-fop-v1/payment-integrator-redirect-fop-api/FormOfPayment)`)` **OPTIONAL** : The form of payment that the user selected for this payment. If the user made no choice or it does not apply, this should be set to `noneChosen`. Required to be set when `result` is set. |\n| Union field `redirectResult`. The result of the redirect payment. `redirectResult` can be only one of the following: ||\n| `result` | `object (`[RedirectPaymentResult](/pay/redirect-fop-v1/payment-integrator-redirect-fop-api/getRedirectPaymentStatus#RedirectPaymentResult)`)` Result of this redirect payment if it was successful, declined, or pending. |\n| `errorResponse` | `object (`[CompleteRedirectErrorResponse](/pay/redirect-fop-v1/google-redirect-fop-api/CompleteRedirectErrorResponse)`)` Details if the redirect failed because of an error. Redirect payments that receive this reply are kept open, and the integrator can later send a `redirectPaymentCompleteNotification` if the payment was successful or declined. |"]]