Resolve a User [v2]
This API helps you decide how you need to make a user login to access their personalised payment methods. The API decides whether you need to collect an otp or not. If no otp needs to be collected, the token for the user will be returned. If an otp needs to be collected then the token will be returned after submission of the otp with the /api/user/verify-otp
Request Body required
This is the mobile number of the user.
Default value: +91
This is the country code as defined by the Internation Telecom Union
The user_agent is a characteristic string that lets servers and network peers identify the application, operating system, vendor, and/or version of the requesting user agent.
A unique numerical identifier for every device or network that connects to the internet. Typically assigned by an internet service provider (ISP), an IP address is an online device address used for communicating across the internet
This is a unique device id generated by the client using a standard library such as fingerprint.js
This is unique order_id generated in the response of create-order
This field isn't used
- 200
- 4XX
- 5XX
When the resolve user request is successful, the response will be as below
Schema
- This key explains the next API that can be called.
- Where the next_step is
payment_mode
, the associateditem
array will contain the token that can be used in subsequent API calls - Where the next_step is
verify_otp
, the /api/user/verify-otp will need to be called to generate the user token - verify_otp
- payment_mode
Possible values: [true
]
This key will always be true
for a successful response
Possible values: [true
]
This field explains whether an otp needs to be collected or not. If otp_sent
is true then an otp needs to be collected
item object required
This is the user information fetched from Nimbbl depending on the user details shared during the resolve user API call
The unique internal id of the consumer
This is the email address of your consumer stored at Nimbbl
This is the first name of your consumer stored at Nimbbl
This is the last name of your consumer stored at Nimbbl
Default value: +91
This is the country code as defined by the Internation Telecom Union
This is the mobile number of your consumer shared by you
This is the unique identifier for the consumer on Nimbbl
Possible values: [false
]
This field explains whether an otp needs to be collected or not. If otp_sent
is false then no otp needs to be collected
item object required
This is the user information fetched from Nimbbl depending on the user details shared during the resolve user API call
The unique internal id of the consumer
This is the email address of your consumer stored at Nimbbl
This is the first name of your consumer stored at Nimbbl
This is the last name of your consumer stored at Nimbbl
Default value: +91
This is the country code as defined by the Internation Telecom Union
This is the mobile number of your consumer shared by you
This is the unique identifier for the consumer on Nimbbl
This is the user token, you will need to add it to the Header for subsequent API calls
This is the expiry of the token, it is expressed in UTC. If the token has expired, you will need to create a new order
{
"success": true,
"next_step": "string"
}
When the resolve user request is not successful, the response will be as below
Schema
The HTTP error status
The message from the server explaining the error
error object
The HTTP error status
The message from the server explaining the error
This is the http status code
The transaction status
error object
The transaction status
The message from the server explaining the error
{}
When there is a problem on the server, the response will be as below
Schema
The HTTP error status
The message from the server explaining the error
{
"status": 500,
"error": "HTTP 500: Internal Server Error"
}