delete
https://uat-accounts.payu.in/api/v3/merchants/8390925/kyc_document/11ef-587e-43837330-95b0-021ec077a271
Delete KYC Document API
Deletes an already uploaded KYC document for a merchant.
Endpoint
DELETE /api/v3/merchants/{merchant_id}/kyc_document/{kyc_document_uuid}
Base URL
- Test:
https://test-partner.payu.in - Production:
https://partner.payu.in
Auth
- Header:
Authorization: Bearer {access_token} - Required scope:
client_manage_kyc_details
Path Parameters
merchant_id(required): MIDkyc_document_uuid(required): UUID returned by Create KYC Document API response atmerchant.kyc_document_uuid
Success Response
204 No Content
Error Responses
404when document UUID does not exist for the merchant (example:{"document":"does not exist"})401/403auth or permission issues
Integration Sequence
- Call
required_docsto identify valid category/type. - Upload via Create KYC Document API.
- Persist
merchant.kyc_document_uuid. - Use that UUID in Delete KYC Document API when document removal is needed.
400Bad Request
401Unauthorized - Invalid or expired token
403Forbidden - No access to this resource
404Not Found
422Validation Failed
500Internal Server Error
