Skip to main content

​
Overview

Service requests use a two-part state system:
  • Primary state: Main stage (DRAFT → QC → UNDERWAY → COMPLETE)
  • Supplement state: Additional context (PENDING, APPROVED, REJECTED, etc.)

​
State combinations

Primary StateSupplement StateDescriptionPartner Action
DRAFT-Just created, missing requirementsComplete payment/images
QCPENDINGQueued for quality control reviewWait for review
QCREJECTEDQuality control found issuesFix issues and resubmit
QCAPPROVEDQuality control passedWait for authentication
QCCOMPLETEFast-track completion during QCCheck final results
UNDERWAYPENDINGReady for authentication assignmentWait for assignment
UNDERWAYASSIGNEDAuthenticator assigned and workingWait for completion
UNDERWAYAPPROVEDAuthentication process completedWait for final results
COMPLETEAPPROVEDAuthentic - Item verified genuineAuthentication passed
COMPLETEREJECTEDNot authentic - Item is counterfeitAuthentication failed
COMPLETECOMPLETEFully processed with documentationAuthentication completed
CANCELLED-Service request cancelledRequest cancelled

​
Workflow

​
Key states to handle

StateAction required
QC + REJECTEDFix issues - Check feedback, add images, or correct details
COMPLETE + APPROVEDAuthentication passed - Item verified as authentic
COMPLETE + REJECTEDAuthentication failed - Item is not authentic
CANCELLEDRequest cancelled - Service request was cancelled

​
Implementation

// Essential state handling
function handleServiceRequestUpdate(sr) {
  if (sr.primary_state === 'QC' && sr.supplement_state === 'REJECTED') {
    showAttentionRequired(sr); // Partner action needed
  }
  
  if (sr.primary_state === 'COMPLETE') {
    if (sr.supplement_state === 'APPROVED') {
      handleAuthentic(sr); // Authentication passed
    } else {
      handleNotAuthentic(sr); // Authentication failed
    }
  }
}

​
Webhooks

Real-time updates are available via webhooks:
  • state_change - Any state transition
  • media_rejected - Images need fixes
  • invalidate_sr - Request cancelled
See webhook events for complete details.