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