Seller KYC

Reject KYC

POST/api/v1/seller/kyc/:id/reject

Rejects a submission — the seller can resubmit afterward.

Requires Authorization

ADMIN, SUPPORT only

Authenticated action

Path parameters

idstringrequired

KYC record ID.

Body parameters

reasonstringrequired

A clear reason — required, and shown to the seller.

Request

curl --request POST \
  --url https://api.swiftgoma.com/api/v1/seller/kyc/:id/reject \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "reason": "<reason>"
}'

200Example response

{
  "success": true,
  "data": {
    "id": "kyc_8f1e2a",
    "sellerProfileId": "sp_2b3c4d",
    "idDocumentType": "NATIONAL_ID",
    "idDocumentUrl": "https://res.cloudinary.com/dx3wclabo/image/upload/v1/kyc/id-aline.jpg",
    "proofOfAddressUrl": "https://res.cloudinary.com/dx3wclabo/image/upload/v1/kyc/address-aline.jpg",
    "selfieUrl": "https://res.cloudinary.com/dx3wclabo/image/upload/v1/kyc/selfie-aline.jpg",
    "rccmNumber": null,
    "rccmDocumentUrl": null,
    "status": "REJECTED",
    "createdAt": "2026-01-06T09:00:00.000Z"
  }
}