Update Onboarding Data

{
  "statusCode": 400,
  "message": "Unable to update. Merchant is not in declined status.",
  "error": "Bad Request"
}

{
  "statusCode": 400,
  "message": "Unable to update. Merchant is not in approved status.",
  "error": "Bad Request"
}

{
  "statusCode": 400,
  "message": "merchantName is required.",
  "error": "Bad Request"
}

{
  "statusCode": 400,
  "message": "Business handle is not available",
  "error": "Bad Request"
}

{
  "statusCode": 400,
  "message": "Invalid onboarding reference number format",
  "error": "Bad Request",
  "details": {
    "refNumReceived": "invalid-uuid"
  }
}

{
  "statusCode": 400,
  "message": "Onboarding record does not exist",
  "error": "Bad Request"
}

{
  "statusCode": 400,
  "message": "Onboarding reference number mismatch",
  "error": "Bad Request",
  "details": {
    "refNumReceived": "550e8400-e29b-41d4-a716-446655440000"
  }
}

{
  "statusCode": 400,
  "message": "Failed to update onboarding record",
  "error": "Bad Request"
}

{
  "statusCode": 401,
  "message": "Account not found",
  "error": "Unauthorized"
}

// 1. Get current data
const currentData = await retrieveOnboardingData(refNo);

// 2. Let user edit the data
const updatedData = await showEditForm(currentData);

// 3. Submit the update
const result = await updateOnboardingData(refNo, updatedData);

const status = await getOnboardingStatus(refNo);

if (status.onboardingStatus === 'DECLINED') {
  console.log('Reason:', status.declinedReason);
  // Show decline reason to user
  // Highlight fields that need correction
}

function validateOnboardingData(data) {
  const errors = [];

  if (!data.merchantName) {
    errors.push('Merchant name is required');
  }

  if (!data.tin || !/^\d+$/.test(data.tin)) {
    errors.push('TIN must contain only numbers');
  }

  if (data.banks.length === 0) {
    errors.push('At least one bank account is required');
  }

  return errors;
}

async function updateWithRetry(refNo, data) {
  try {
    return await updateOnboardingData(refNo, data);
  } catch (error) {
    if (error.message.includes('Business handle is not available')) {
      // Suggest alternative handles
      data.businessHandle = `${data.businessHandle}-${Date.now()}`;
      return await updateOnboardingData(refNo, data);
    }
    throw error;
  }
}

// Don't just update changed fields
const updateData = {
  ...currentData, // Start with all current data
  ...changedFields, // Override with changes
  // This preserves optional fields like websites, signatories, etc.
};