Requests the integrator send an OTP to the phone number.
If the integrator returns SUCCESS
, then Google expects an SMS sent to the phone number.
Google provides only an accountPhoneNumber
when a user initially associates their account with Google. Thereafter, only associationId
would be sent for all subsequent calls.
If the endpoint encounters an error while processing the request, the response body from this endpoint should be of type
.ErrorResponse
An example request looks like:
{
"requestHeader": {
"protocolVersion": {
"major": 1,
"minor": 0,
"revision": 0
},
"requestId": "0123434-otp-abc",
"requestTimestamp": "1502545413026"
},
"accountPhoneNumber": "+918067218010",
"smsMatchingToken": "AB12345678C",
"otpContext": {
"association": {}
}
}
An example response looks like:
{
"responseHeader": {
"responseTimestamp": "1502545413098"
},
"paymentIntegratorSendOtpId": "99==ABC EF",
"result": "SUCCESS"
}
HTTP request
POST https://www.integratorhost.example.com/integrator-base-path/e-wallets-v1/sendOtp
Request body
The request body contains data with the following structure:
JSON representation |
---|
{ "requestHeader": { object ( |
Fields | |
---|---|
requestHeader |
REQUIRED: Common header for all requests. |
smsMatchingToken |
REQUIRED: This value is provided by Google and must be included in the SMS delivered to the user. This allows Google to auto-match the SMS on the device for Android O devices (see reference ). This will be 11 characters. So for example, if the SMS normally looks like:
And Google sends "0123456789A" for this field, then the SMS should look like:
Here's the OTP you requested: YYXXZZ Alternatively it could look like:
0123456789A |
otpContext |
OPTIONAL: This is the context in which an OTP is being requested. |
Union field account_identifier . REQUIRED: This is the identifier of the account for which an OTP needs to be sent. account_identifier can be only one of the following: |
|
accountPhoneNumber |
This is a E.164 formatted phone number. Examples include +14035551111 and +918067218000. This will always lead with a + and include only numbers afterwards (no dashes). This is populated when a user initially associates their account with Google and during reassociation. |
associationId |
This is the association identifier used to reference a user's account. This is populated for all subsequent calls after initial association. |
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.
Possible response messages | |
---|---|
HTTP 200 Status |
|
HTTP 4XX / 5XX Status |
|
OtpContext
Context in which an OTP is being requested.
JSON representation |
---|
{ // Union field |
Fields | |
---|---|
Union field otp_context . REQUIRED: Context in which an OTP is being requested. otp_context can be only one of the following: |
|
association |
OTP is being requested in the context of association/re-association. |
mandateCreation |
OTP is being requested in the context of mandate creation. |
associationWithMandateCreation |
OTP is being requested for association along with mandate creation. |
SendOtpResponse
Response object for the sendOtp method.
JSON representation |
---|
{ "responseHeader": { object ( |
Fields | |
---|---|
responseHeader |
REQUIRED: Common header for all responses. |
paymentIntegratorSendOtpId |
OPTIONAL: Identifier the integrator knows this send OTP request as. This is integrator generated. |
result |
REQUIRED: Result of this request |
SendOtpResultCode
Result codes for send OTP request.
Enums | |
---|---|
UNKNOWN_RESULT |
Do not ever set this default value! |
SUCCESS |
Integrator has sent the OTP. |
PHONE_NUMBER_NOT_ASSOCIATED_WITH_ACCOUNT |
Phone number isn't associated with the account identified by associationId . |
UNKNOWN_PHONE_NUMBER |
Phone number isn't associated with any account. This is used when the associationId isn't set. |
MESSAGE_UNABLE_TO_BE_SENT |
Integrator couldn't send the OTP for some reason. This is a transient error, and may result in this call being retried. |
INVALID_PHONE_NUMBER |
The phone number format was incorrect. |
NOT_ELIGIBLE |
User's account is not eligible for this service. |
OTP_LIMIT_REACHED |
User has requested or tried to verify too many OTPs. |
ACCOUNT_CLOSED |
The user's account held with the integrator has been closed. This should only be used when the "associationId" is being used to identify this user. Returning this value will cause the user's instrument to be closed with Google. The user will be forced to add a new instrument by going through the association flow again. |
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER |
The user's account with the integrator has been closed, suspected account take over. This should only be used when the "associationId" is being used to identify this user. Returning this value will cause the user's instrument to be closed with Google. The user will be forced to add a new instrument by going through the association flow again. |
ACCOUNT_CLOSED_FRAUD |
The user's account held with the integrator has been closed because of fraud. This should only be used when the "associationId" is being used to identify this user. Returning this value will cause the user's instrument to be closed with Google. The user will be forced to add a new instrument by going through the association flow again. |