Skip to main content

Jio Failure Response

Device Binding

Failure response is of two types:

a. Validation Failure Response

In case of validation failure, return JSON response.

Example:

{
"success": false,
"errors": [
{
"reason": "error",
"details": "error description"
}
]
}
ParameterData TypeDescriptionMandatory
successBooleanFalse (Error Case)Yes
errors[0].reasonStringError reasonYes
errors[0].detailsStringError descriptionYes

b. Redirect URL Failure Response

In case of other failures, the error is returned to the redirect URL of the UPI App Backend.

To be handled by Sinch.

URL Format

<UPIApp-Backend-Redirect-URL>?result=<error_code>&state=<state-parameter-received-in-request>&description=<description-of-error>

Sample Failure URL

<UPIApp-Backend-Redirect-URL>?result=INVALID_MSISDN&state=7018cfa9-75ba-4e16-8015
ParameterData TypeDescriptionMandatory
stateStringState parameter received in Device Binding API requestYes
resultStringError code (for example: INVALID_MSISDN)Yes
descriptionStringDescription of errorYes

Signature Verify API

Error Response Body Parameters.

To be handled by Sinch.

ParameterData TypeDescriptionMandatory
successBooleanFalse (Error Case)Yes
errors[0].reasonStringError reasonYes
errors[0].detailsStringError descriptionYes
stateStringRequest unique ID to maintain state between the Device Binding API and UPI App Backend redirect URIYes

Common Error Response Codes From Jio

HTTP Status CodeCode Returned to Partner
401INVALID_CLIENT
403ACCESS_DENIED
400INVALID_REQUEST
500SERVER_ERROR