- [HTTP request](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#body.HTTP_TEMPLATE)
- [Request body](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#body.request_body)
  - [JSON representation](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#body.request_body.SCHEMA_REPRESENTATION)
- [Response body](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#body.response_body)
- [AuthenticationType](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#AuthenticationType)
  - [JSON representation](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#AuthenticationType.SCHEMA_REPRESENTATION)
- [RedirectUrl](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectUrl)
  - [JSON representation](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectUrl.SCHEMA_REPRESENTATION)
- [NativeOtp](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtp)
  - [JSON representation](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtp.SCHEMA_REPRESENTATION)
- [AdditionalAuthenticationContext](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#AdditionalAuthenticationContext)
  - [JSON representation](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#AdditionalAuthenticationContext.SCHEMA_REPRESENTATION)
- [AuthenticateResponse](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#AuthenticateResponse)
  - [JSON representation](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#AuthenticateResponse.SCHEMA_REPRESENTATION)
- [RedirectUrlResultCase](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectUrlResultCase)
  - [JSON representation](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectUrlResultCase.SCHEMA_REPRESENTATION)
- [RedirectUrlNotRequested](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectUrlNotRequested)
  - [JSON representation](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectUrlNotRequested.SCHEMA_REPRESENTATION)
- [RedirectUrlSupport](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectUrlSupport)
  - [JSON representation](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectUrlSupport.SCHEMA_REPRESENTATION)
- [RedirectUrlNotSupported](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectUrlNotSupported)
  - [JSON representation](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectUrlNotSupported.SCHEMA_REPRESENTATION)
- [RedirectUrlNotSupportedReason](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectUrlNotSupportedReason)
  - [JSON representation](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectUrlNotSupportedReason.SCHEMA_REPRESENTATION)
- [RedirectDetails](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectDetails)
  - [JSON representation](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectDetails.SCHEMA_REPRESENTATION)
- [GetRequest](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#GetRequest)
  - [JSON representation](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#GetRequest.SCHEMA_REPRESENTATION)
- [PostFormRequest](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#PostFormRequest)
  - [JSON representation](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#PostFormRequest.SCHEMA_REPRESENTATION)
- [BodyPair](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#BodyPair)
  - [JSON representation](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#BodyPair.SCHEMA_REPRESENTATION)
- [BodyEncoding](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#BodyEncoding)
- [NativeOtpResultCase](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpResultCase)
  - [JSON representation](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpResultCase.SCHEMA_REPRESENTATION)
- [NativeOtpNotRequested](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpNotRequested)
  - [JSON representation](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpNotRequested.SCHEMA_REPRESENTATION)
- [NativeOtpSupport](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpSupport)
  - [JSON representation](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpSupport.SCHEMA_REPRESENTATION)
- [NativeOtpNotSupported](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpNotSupported)
  - [JSON representation](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpNotSupported.SCHEMA_REPRESENTATION)
- [NativeOtpNotSupportedReason](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpNotSupportedReason)
  - [JSON representation](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpNotSupportedReason.SCHEMA_REPRESENTATION)
- [NativeOtpResult](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpResult)
  - [JSON representation](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpResult.SCHEMA_REPRESENTATION)
- [NativeOtpResultCode](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpResultCode)
  - [JSON representation](https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpResultCode.SCHEMA_REPRESENTATION)

Initiates the authentication of a user for a card to make a purchase. This can be accomplished in multiple ways that may or may not be supported for the specified card. The payment integrator attempts to authenticate using all specified methods that are supported by the card.

If `NATIVE_OTP` is specified within the `supportedAuthenticationTypes`, the issuer should immediately send an OTP to the cardholder, using the information already on file.

If the endpoint encounters an error while processing the request, the response body from this endpoint should be of type `https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/ErrorResponse`.

An example request using a physical card looks like:


    {
      "requestHeader": {
        "protocolVersion": {
          "major": 1
        },
        "requestId": "G112YZH4XPDV88J",
        "requestTimestamp": {
          "epochMillis": "1481907920000"
        },
        "paymentIntegratorAccountId": "SpeedyPaymentsIndia_INR"
      },
      "accountDetails": {
        "card": {
          "accountNumber": "4123456789101112",
          "nameOnCard": "Example Customer",
          "expiryMonth": "01",
          "expiryYear": "20",
          "cvn": "123"
        }
      },
      "amount": {
        "amountMicros": "728000000",
        "currencyCode": "INR"
      },
      "requestedAuthenticationTypes": {
        "redirectUrl": {
          "callbackUrl": "https://example.google.com/return/url/"
        },
        "nativeOtp": {
          "deviceInformation": {
            "userAgent": "Mozilla/5.0 (WindowsNT10.0)",
            "userIpAddress": "2001:4860:4860::8888"
          }
        }
      }
    }

An example request using a tokenized card looks like:


    {
      "requestHeader": {
        "protocolVersion": {
          "major": 1
        },
        "requestId": "G112YZH4XPDV88J",
        "requestTimestamp": {
          "epochMillis": "1481907920000"
        },
        "paymentIntegratorAccountId": "SpeedyPaymentsIndia_INR"
      },
      "accountDetails": {
        "paymentToken": {
          "nameOnCard": "Example Customer",
          "paymentTokenAccountNumber": "4123456789101112",
          "expiryMonth": "01",
          "expiryYear": "20",
          "cryptogram": "12345"
        }
      },
      "amount": {
        "amountMicros": "728000000",
        "currencyCode": "INR"
      },
      "requestedAuthenticationTypes": {
        "redirectUrl": {
          "callbackUrl": "https://example.google.com/return/url/"
        },
        "nativeOtp": {
          "deviceInformation": {
            "userAgent": "Mozilla/5.0 (WindowsNT10.0)",
            "userIpAddress": "2001:4860:4860::8888"
          }
        }
      }
    }

An example response looks like:


    {
      "responseHeader": {
        "responseTimestamp": {
          "epochMillis": 1481907920760
        }
      },
      "paymentIntegratorAuthenticationId": "36be1a5d-ff21-455d-8dba-e3c4306e193e",
      "cvnResult": "CVN_RESULT_NOT_DETERMINED",
      "redirectUrlResultCase": {
        "redirectUrlResult": {
          "getMethod": {
            "url": "https://example.paymentintegratordomain.com/authenitcate/G112YZH4XPDV88J"
          }
        }
      },
      "nativeOtpResultCase": {
        "nativeOtpNotSupported": {
          "nativeOtpNotSupportedReason": {
            "notSupportedByIssuer": {}
          }
        }
      }
    }

### HTTP request

`POST https://www.integratorhost.example.com/integrator-base-path/v1/payment-integrator-authenticated-card-fop-api/authenticate`

### Request body

The request body contains data with the following structure:

| JSON representation |
|---|
| ``` { "requestHeader": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/RequestHeader`) }, "accountDetails": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/AccountDetails`) }, "amount": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Amount`) }, "requestedAuthenticationTypes": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#AuthenticationType`) }, "additionalAuthenticationContext": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#AdditionalAuthenticationContext`) } } ``` |

| Fields ||
|---|---|
| `requestHeader` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/RequestHeader`)`` **REQUIRED**: Common header for all requests. |
| `accountDetails` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/AccountDetails`)`` **REQUIRED**: Data about the user's payment card. |
| `amount` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Amount`)`` **REQUIRED**: The amount of the purchase if the authentication is successful. |
| `requestedAuthenticationTypes` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#AuthenticationType`)`` **REQUIRED**: The types of authentication methods being requested. |
| `additionalAuthenticationContext` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#AdditionalAuthenticationContext`)`` **OPTIONAL**: Contains additional information relevant to processing the authentication. |

### Response body

This method supports multiple return types. For additional information about what 4XX or 5XX HTTP status code to return with an `ErrorResponse`, consult the `ErrorResponse` object and [HTTP status codes documentation](https://developers.google.com/pay/india-cards-v1/guides/connectivity/protocol-standards#http_status_codes).

| Possible response messages ||
|---|---|
| HTTP 200 Status | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#AuthenticateResponse`)`` |
| HTTP 4XX / 5XX Status | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/ErrorResponse`)`` |
| End of mutually exclusive fields. ||

## AuthenticationType

Defines the possible ways of authenticating a user. At least one type must be requested.

| JSON representation |
|---|
| ``` { "redirectUrl": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectUrl`) }, "nativeOtp": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtp`) } } ``` |

| Fields ||
|---|---|
| `redirectUrl` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectUrl`)`` **OPTIONAL**: Used when requesting authentication by redirect URL. |
| `nativeOtp` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtp`)`` **OPTIONAL**: Used when requesting authentication by native OTP. |

## RedirectUrl

Redirect URL authentication information.

| JSON representation |
|---|
| ``` { "callbackUrl": string, "deviceInformation": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/DeviceInformation`) } } ``` |

| Fields ||
|---|---|
| `callbackUrl` | `string` **REQUIRED**: This is the callback URL the user is sent to after completion of the redirect. |
| `deviceInformation` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/DeviceInformation`)`` **OPTIONAL** : This is the information about the user's browser that will be loading the `url` sent in the `RedirectUrlResult`. If this information is provided it can be used in generating the `redirectUrl`. For instance, the `userAgent` can be used to custimize a page that matches the user's browser and the `ipAddress` can be used to verify that the correct user is being redirected. |

## NativeOtp

Native OTP authentication information.

| JSON representation |
|---|
| ``` { "smsMatchingToken": string, "deviceInformation": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/DeviceInformation`) } } ``` |

| Fields ||
|---|---|
| `smsMatchingToken` | `string` **OPTIONAL**: A string to be included with the SMS, if possible, so that the device can automatically ingest the token. |
| `deviceInformation` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/DeviceInformation`)`` **OPTIONAL**: This is the information about the user's device where this transaction was initiated. This field is present only when it is required for generating the OTP. If the particular contract does not stipulate the need for this field, it will always be empty. |

## AdditionalAuthenticationContext

Contains additional authentication information required at the time of authentication.

| JSON representation |
|---|
| ``` { "installmentData": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/InstallmentData`) } } ``` |

| Fields ||
|---|---|
| `installmentData` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/InstallmentData`)`` **REQUIRED**: Contains the installment data for the payment for which authentication is being attempted. |

## AuthenticateResponse

Response object for the payment integrator hosted `authenticate` method.

| JSON representation |
|---|
| ``` { "responseHeader": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/ResponseHeader`) }, "paymentIntegratorAuthenticationId": string, "cvnResult": enum (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/CvnResult`), "redirectUrlResultCase": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectUrlResultCase`) }, "nativeOtpResultCase": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpResultCase`) } } ``` |

| Fields ||
|---|---|
| `responseHeader` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/ResponseHeader`)`` **REQUIRED**: Common header for all responses. |
| `paymentIntegratorAuthenticationId` | `string` **OPTIONAL**: This identifier is specific to the integrator and is generated by the integrator. The integrator identifies this authentication attempt in their system by this identifier. |
| `cvnResult` | ``enum (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/CvnResult`)`` **REQUIRED** : The result of verifying the CVN sent in the request. If the CVN was not set on the request, this value should be `NOT_SENT`. |
| `redirectUrlResultCase` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectUrlResultCase`)`` **REQUIRED** A container for the result of the `redirectUrl` request. |
| `nativeOtpResultCase` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpResultCase`)`` **REQUIRED** A container for the result of the `nativeOtp` request. |

## RedirectUrlResultCase

A container for the result of the `redirectUrl` request.

| JSON representation |
|---|
| ``` { // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "redirectUrlNotRequested": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectUrlNotRequested`) }, "redirectUrlNotSupported": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectUrlNotSupported`) }, "redirectUrlResult": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectDetails`) } // End of mutually exclusive fields. } ``` |

| Fields ||
|---|---|
| **REQUIRED** : The result of the `redirectUrl` request. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response: ||
| `redirectUrlNotRequested` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectUrlNotRequested`)`` Google did not request authentication by `redirectUrl` so nothing could be done. |
| `redirectUrlNotSupported` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectUrlNotSupported`)`` Google requested authentication by `redirectUrl` but it is not supported. |
| `redirectUrlResult` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectDetails`)`` Google requested authentication by `redirectUrl` and this is the result. |
| End of mutually exclusive fields. ||

## RedirectUrlNotRequested

This is used when a `redirectUrl` was not requested.

| JSON representation |
|---|
| ``` { "redirectUrlSupport": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectUrlSupport`) } } ``` |

| Fields ||
|---|---|
| `redirectUrlSupport` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectUrlSupport`)`` **REQUIRED** : This is used to indicated if a `redirectUrl` would have been supported if it had been requested. |

## RedirectUrlSupport

This is used to specify if a `redirectUrl` would have been supported for a particular request.

| JSON representation |
|---|
| ``` { // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "notSupportedByPaymentIntegrator": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`) }, "notSupportedByNetwork": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`) }, "notSupportedByIssuer": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`) }, "notEnrolled": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`) }, "supported": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`) } // End of mutually exclusive fields. } ``` |

| Fields ||
|---|---|
| **REQUIRED** : Whether a `redirectUrl` would have been supported for this request, or the reason it would not have been supported. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response: ||
| `notSupportedByPaymentIntegrator` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`)`` The payment integrator can not support a `redirectUrl` for this request. |
| `notSupportedByNetwork` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`)`` The network can not support a `redirectUrl` for this request. |
| `notSupportedByIssuer` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`)`` The issuer can not support a `redirectUrl` for this request. |
| `notEnrolled` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`)`` A `redirectUrl` is not supported for this request because the card has not been enrolled. |
| `supported` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`)`` A `redirectUrl` is supported for this request. |
| End of mutually exclusive fields. ||

## RedirectUrlNotSupported

This is used when a `redirectUrl` was requested but it is unsupported for this request.

| JSON representation |
|---|
| ``` { "reason": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectUrlNotSupportedReason`) } } ``` |

| Fields ||
|---|---|
| `reason` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#RedirectUrlNotSupportedReason`)`` **REQUIRED** : Authentication by `redirectUrl` was requested, but it could not be performed for the following reason. |

## RedirectUrlNotSupportedReason

The reasons why `redirectUrl` could not be performed.

| JSON representation |
|---|
| ``` { // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "notSupportedByPaymentIntegrator": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`) }, "notSupportedByNetwork": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`) }, "notSupportedByIssuer": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`) }, "notEnrolled": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`) }, "doNotHonor": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`) }, "invalidExpiry": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`) } // End of mutually exclusive fields. } ``` |

| Fields ||
|---|---|
| **REQUIRED** : The reason `redirectUrl` could not be performed. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response: ||
| `notSupportedByPaymentIntegrator` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`)`` The integrator could not support `redirectUrl` for this request. |
| `notSupportedByNetwork` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`)`` The network could not support `redirectUrl` for this request. |
| `notSupportedByIssuer` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`)`` The issuer could not support `redirectUrl` for this request. This would include international cards that don't support the `redirectUrl` authentication flow. |
| `notEnrolled` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`)`` The user is not enrolled to support `redirectUrl` for this request. This is used for cases where a `redirectUrl` would have been supported but the user has not yet completed the necessary steps to enable it as a valid option. |
| `doNotHonor` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`)`` The issuer returned a `DO_NOT_HONOR` for this request. |
| `invalidExpiry` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`)`` The expiry date for this request is invalid. |
| End of mutually exclusive fields. ||

## RedirectDetails

This contains the result of the `redirectUrl` request when it is supported.

| JSON representation |
|---|
| ``` { // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "getMethod": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#GetRequest`) }, "postFormMethod": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#PostFormRequest`) } // End of mutually exclusive fields. } ``` |

| Fields ||
|---|---|
| **REQUIRED**: Specifies the type of redirect that will be used. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response: ||
| `getMethod` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#GetRequest`)`` The user's browser should be redirected using an HTTPS GET. |
| `postFormMethod` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#PostFormRequest`)`` The user's browser should be redirected using an HTTPS POST with content time `x-www-form-urlencoded`. |
| End of mutually exclusive fields. ||

## GetRequest

This contains details for redirecting the user's browser using an HTTPS GET.

| JSON representation |
|---|
| ``` { "url": string } ``` |

| Fields ||
|---|---|
| `url` | `string` **REQUIRED**: The URL that the user's browser should be redirected to with a GET request. Should not exceed 2048 characters in length. |

## PostFormRequest

This contains details for redirecting the user's browser using an HTTPS POST.

| JSON representation |
|---|
| ``` { "url": string, "body": [ { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#BodyPair`) } ], "bodyEncoding": enum (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#BodyEncoding`) } ``` |

| Fields ||
|---|---|
| `url` | `string` **REQUIRED**: The url the user will be redirected to. Should not exceed 2048 characters in length. |
| `body[]` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#BodyPair`)`` **REQUIRED**: Data for the body of the POST for the redirect. This list represents the HTTPS POST body. For example: `[ "myParammy": "Val", "otherParam": "otherVal", "repeatedParam": "val1", "repeatedParam": "val2" ]` Would be formatted as this in the POST body: `myParam=myVal&otherParam=otherVal&repeatedParam=val1&repeatedParam= val2`. <br /> > [!NOTE] > **Note:** When redirecting the user's browser, the content type will be set to `x-www-form-urlencoded` <br /> |
| `bodyEncoding` | ``enum (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#BodyEncoding`)`` **REQUIRED**: The character set used for the body. UTF-8 is recommended. |

## BodyPair

Data for the body of the POST for the redirect.

| JSON representation |
|---|
| ``` { "name": string, "value": string } ``` |

| Fields ||
|---|---|
| `name` | `string` **REQUIRED**: Name of the parameter. |
| `value` | `string` **REQUIRED**: Value of the parameter. |

## BodyEncoding

The character set used for the body. UTF-8 is recommended.

| Enums ||
|---|---|
| `BODY_ENCODING_UNSPECIFIED` | DO NOT USE |
| `BODY_ENCODING_ISO_8859_1` | ISO-8859-1 character set for the POST body |
| `BODY_ENCODING_UTF_8` | UTF-8 character set for the POST body |
| `BODY_ENCODING_US_ASCII` | US-ASCII character set for the POST body |

## NativeOtpResultCase

A container for the result of the `nativeOtp` request.

| JSON representation |
|---|
| ``` { // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "nativeOtpNotRequested": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpNotRequested`) }, "nativeOtpNotSupported": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpNotSupported`) }, "nativeOtpResult": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpResult`) } // End of mutually exclusive fields. } ``` |

| Fields ||
|---|---|
| **REQUIRED** : The result of the `nativeOtp` request. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response: ||
| `nativeOtpNotRequested` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpNotRequested`)`` Google did not request authentication by `nativeOtp` so nothing could be done. |
| `nativeOtpNotSupported` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpNotSupported`)`` Google requested authentication by `nativeOtp` but native OTP is not supported. |
| `nativeOtpResult` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpResult`)`` Google requested authentication by `nativeOtp` and this is the result. |
| End of mutually exclusive fields. ||

## NativeOtpNotRequested

This is used when a `nativeOtp` was not requested.

| JSON representation |
|---|
| ``` { "nativeOtpSupport": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpSupport`) } } ``` |

| Fields ||
|---|---|
| `nativeOtpSupport` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpSupport`)`` **REQUIRED** : If authentication by `nativeOtp` was requested, the following support would have been available. |

## NativeOtpSupport

This is used to specify if a `nativeOtp` would have been supported for a particular request.

| JSON representation |
|---|
| ``` { // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "notSupportedByPaymentIntegrator": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`) }, "notSupportedByNetwork": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`) }, "notSupportedByIssuer": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`) }, "notEnrolled": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`) }, "supported": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`) }, "invalidExpiry": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`) } // End of mutually exclusive fields. } ``` |

| Fields ||
|---|---|
| **REQUIRED** : Whether a `nativeOtp` would have been supported for this request, or the reason it would not have been supported. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response: ||
| `notSupportedByPaymentIntegrator` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`)`` The payment integrator can not support a `nativeOtp` for this request. |
| `notSupportedByNetwork` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`)`` The network can not support a `nativeOtp` for this request. |
| `notSupportedByIssuer` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`)`` The issuer can not support a `nativeOtp` for this request. |
| `notEnrolled` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`)`` A `nativeOtp` is not supported for this request because the card has not been enrolled. |
| `supported` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`)`` A `nativeOtp` is supported for this request. |
| `invalidExpiry` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`)`` The expiry date for this request is invalid. |
| End of mutually exclusive fields. ||

## NativeOtpNotSupported

This is used when a `nativeOtp` was requested but it is not supported for this request.

| JSON representation |
|---|
| ``` { "nativeOtpNotSupportedReason": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpNotSupportedReason`) } } ``` |

| Fields ||
|---|---|
| `nativeOtpNotSupportedReason` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpNotSupportedReason`)`` **REQUIRED** : Authentication by `nativeOtp` was requested, but it could not be performed for the following reason. |

## NativeOtpNotSupportedReason

The reasons why `nativeOtp` could not be performed.

| JSON representation |
|---|
| ``` { // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "notSupportedByPaymentIntegrator": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`) }, "notSupportedByNetwork": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`) }, "notSupportedByIssuer": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`) }, "notEnrolled": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`) }, "doNotHonor": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`) } // End of mutually exclusive fields. } ``` |

| Fields ||
|---|---|
| **REQUIRED** : The reason `nativeOtp` could not be performed. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response: ||
| `notSupportedByPaymentIntegrator` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`)`` The integrator could not support `nativeOtp` for this request. |
| `notSupportedByNetwork` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`)`` The network could not support `nativeOtp` for this request. |
| `notSupportedByIssuer` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`)`` The issuer could not support `nativeOtp` for this request. This would include international cards that don't support the `redirectUrl` authentication flow. |
| `notEnrolled` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`)`` The user is not enrolled to support `nativeOtp` for this request. This is used for cases where a `nativeOtp` would have been supported but the user has not yet completed the necessary steps to enable it as a valid option. |
| `doNotHonor` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`)`` The issuer returned a `DO_NOT_HONOR` for this request. |
| End of mutually exclusive fields. ||

## NativeOtpResult

This is used when a `nativeOtp` was requested and is supported.

| JSON representation |
|---|
| ``` { "result": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpResultCode`) } } ``` |

| Fields ||
|---|---|
| `result` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/authenticate#NativeOtpResultCode`)`` **REQUIRED**: The result of requesting that an OTP be sent to the user. |

## NativeOtpResultCode

Result codes for `NativeOtpResult`.

| JSON representation |
|---|
| ``` { // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "otpSent": { object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`) } // End of mutually exclusive fields. } ``` |

| Fields ||
|---|---|
| **REQUIRED**: The result of requesting that an OTP be sent to the user. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response: ||
| `otpSent` | ``object (`https://developers.google.com/pay/india-cards-v1/payment-integrator-india-cards-api/Empty`)`` An OTP has successfully be sent to the user using by the issuer using information they had stored. |
| End of mutually exclusive fields. ||