Use this API to approve or reject KYC request
Note : Copy the CURL only after filling the input parameters
For API Base URL's, click here. Kindly append the Base URL to the API endpoints below to integrate
Digio Apis
Email:
support@digio.in
Getting started with Digio Rest Apis
API SERVER
SELECTED: https://api.digio.in
AUTHENTICATION
No API key applied
|
HTTP Basic
Send
Authorization in header containing the word Basic followed by a space and a base64 encoded string of username:password.
|
General ⦂
Approval/Rejection of KYC request
post
{BASE_URL}/client/kyc/v2/request/{requestId}/manage_approval
Request Body Params (application/json)
Allowed:
requested
| approval_pending
| approved
| rejected
| failed
| expired
| skipped
Approve or reject a KYC request
Requires
Base 64 encoded clientId:clientSecret in Authorization header
REQUEST
PATH PARAMETERS
|
*
requestId
string
|
|||
|
Unique identifier referencing the KYC request as returned in response to request creation. (Eg. KID…..) |
|||
REQUEST BODY
application/json
{
"status": "requested"
}
object
Single line description
Field
Type
Description
status
*
enum
➔
Allowed: requested┃approval_pending┃approved┃rejected┃failed┃expired┃skipped
API Server
https://api.digio.in
Authentication
Required (None Applied)
curl -X POST "https://api.digio.in/client/kyc/v2/request/{requestId}/manage_approval" \
-H 'accept: application/json'
RESPONSE
application/json
object
Single line description
Field
Type
Description
id
string
Unique identifier referencing a request.
created_at
date-time
Time of creation of a request.
status
enum
➔ Status of the request. “requested” immediately post creation
Allowed: requested┃approval_pending┃approved┃rejected┃failed┃expired┃skipped
customer_identifier
string
Customer email/phone number as passed in the request.
-
actions
array of object
LIST of details of steps configured in workflow along with approved/reject status
⮕ [ LIST of details of steps configured in workflow along with approved/reject status ]
id
string
step_request_id
string
action_ref
string
type
enum
➔
Allowed: video┃image┃selfie┃aadhaar_offline┃two_way_video┃digilocker┃penny_drop┃generic┃document_flow┃fund_collection
status
enum
➔
Allowed: requested┃success┃approval_pending┃approved┃rejected┃failed┃expired┃skipped
file_id
string
sub_file_id
string
execution_request_id
string
-
validation_result
object
-
[any-key]
object
completed_at
date-time
face_match_obj_type
enum
➔
Allowed: source┃match_required┃strict_match_required┃none
face_match_status
enum
➔
Allowed: na┃new┃halted┃failed┃done
obj_analysis_status
enum
➔
Allowed: na┃new┃halted┃failed┃done
method
enum
➔
Allowed: otp_text┃otp_audio┃otp_none
otp
string
processing_done
boolean
retry_count
integer
reference_id
string
Internal reference ID as passed in the request.
-
request_details
object
Data passed in the request that is displayed on the dashboard, usually to help an agent make a decision.
[any-key]
string
Data passed in the request that is displayed on the dashboard, usually to help an agent make a decision.
transaction_id
string
As passed in the request. Generated by the system and returned if not passed.
customer_name
string
The name of the customer
expire_in_days
integer
No. of days after which the KYC request will expire.
reminder_registered
boolean
States if there is any reminder registered.
workflow_name
string
Name of the workflow.
auto_approved
boolean
States weather auto approved.
auditor_name
string
Name of the auditor
auditor_identifier
string
Unique identifier referencing auditor.
application/json
object
Single line description
Field
Type
Description
details
string
Details about the exception. Usually contains the exception id for reference.
code
string
Error code
message
string
Description of the error